Функция DismountNtmsDrive (ntmsapi.h)

[Диспетчер съемных носителей больше недоступен в Windows 7 и Windows Server 2008 R2.]

Функция DismountNtmsDrive помещает в очередь команду для перемещения носителя на указанном диске в слот хранилища. Эта функция должна быть связана с функцией MountNtmsMedia .

Синтаксис

DWORD DismountNtmsDrive(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpDriveId
);

Параметры

[in] hSession

Дескриптор сеанса, возвращаемого функцией OpenNtmsSession .

[in] lpDriveId

Уникальный идентификатор объекта диска.

Возвращаемое значение

Эта функция возвращает одно из следующих значений.

Значение Значение
ERROR_ACCESS_DENIED
NTMS_MODIFY_ACCESS в библиотеку запрещено. Возможны и другие ошибки безопасности, но они указывают на ошибку подсистемы безопасности.

Windows XP: NTMS_CONTROL_ACCESS в библиотеку запрещено. Возможны и другие ошибки безопасности, но они указывают на ошибку подсистемы безопасности.

ERROR_DATABASE_FAILURE
База данных недоступна или повреждена.
ERROR_DATABASE_FULL
База данных заполнена.
ERROR_DEVICE_NOT_AVAILABLE
Диск или библиотека не включены.
ERROR_INVALID_DRIVE
Недопустимый идентификатор диска.
ERROR_INVALID_HANDLE
Дескриптор сеанса отсутствует или недопустим.
ERROR_INVALID_LIBRARY
Недопустимая библиотека для диска.
ERROR_INVALID_PARAMETER
Отсутствует идентификатор диска.
ERROR_INVALID_STATE
Диск не содержит мультимедиа.
ERROR_NOT_ENOUGH_MEMORY
Во время обработки произошел сбой выделения.
ERROR_SUCCESS
Функция выполнена успешно.

Комментарии

Если диск, указанный функцией DismountNtmsDrive , пуст или если открыт носитель, возвращается ошибка. В противном случае носитель возвращается в свой слот.

Запросы на отключение автономных дисков помещали диск в отключенное состояние и возвращали успешное выполнение.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header ntmsapi.h
Библиотека Ntmsapi.lib
DLL Ntmsapi.dll

См. также раздел

Функции управления библиотекой