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

  • Статья

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

Функция DisableNtmsObject отключает указанный объект RSM.

Синтаксис

DWORD DisableNtmsObject(
  [in] HANDLE      hSession,
  [in] DWORD       dwType,
  [in] LPNTMS_GUID lpObjectId
);

Параметры

[in] hSession

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

[in] dwType

Тип объекта RSM. Этот параметр может иметь одно из следующих значений из типа перечисления NtmsObjectsTypes .

Значение Значение
NTMS_DRIVE
 Накопитель
NTMS_LIBRARY
 Библиотека
NTMS_PHYSICAL_MEDIA
 Физический носитель (ленточный, оптический диск, компакт-диск или магнитный патрон)

[in] lpObjectId

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

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

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

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

Windows XP: NTMS_CONTROL_ACCESS библиотеке, содержащей объект , запрещено. Возможны и другие ошибки безопасности, но они указывают на ошибку подсистемы безопасности.
ERROR_DATABASE_FAILURE
 База данных недоступна или повреждена.
ERROR_INVALID_HANDLE
 Дескриптор сеанса отсутствует или недопустим.
ERROR_INVALID_PARAMETER
 Отсутствует идентификатор объекта или недопустимый тип объекта. (Недопустимый тип объекта, если он не NTMS_LIBRARY, NTMS_DRIVE или NTMS_PHYSICAL_MEDIA.)
ERROR_INVALID_STATE
 Объект уже отключен.
ERROR_LIBRARY_OFFLINE
 Идентификатор библиотеки относится к автономной библиотеке, которую нельзя включить или отключить.
ERROR_OBJECT_NOT_FOUND
 Недопустимый объект.
ERROR_SUCCESS
 Отключение помещается в очередь.

Комментарии

Функция DisableNtmsObject помещает в очередь команду disable для указанного объекта. Функция успешно возвращается, когда команда находится в очереди. Если RSM занят, выполнение команды может занять некоторое время. Если среда отключена, RSM делает все стороны носителя и связанные с ним логические носители недоступными. Все запросы на отключенный носитель возвращают ошибки.

Чтобы удалить диск или средство смены мультимедиа из службы, необходимо сначала отключить диск или средство смены мультимедиа.

Все объекты, содержащиеся в отключенном объекте, также отключены. Например, при отключении части физического носителя отключается все стороны. По возможности при отключении диска носитель на диске удаляется и помещается в его слот.

Требования

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

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

EnableNtmsObject

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