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

  • Статья

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

Функция ReserveNtmsCleanerSlot резервирует один слот в блоке библиотеки для патрона для очистки диска.

Синтаксис

DWORD ReserveNtmsCleanerSlot(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpLibrary,
  [in] LPNTMS_GUID lpSlot
);

Параметры

[in] hSession

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

[in] lpLibrary

Уникальный идентификатор библиотеки для резервирования слота очистки.

[in] lpSlot

Уникальный идентификатор слота, который должен быть зарезервирован для более чистого патрона.

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

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

Значение Значение
ERROR_ACCESS_DENIED
 NTMS_CONTROL_ACCESS в библиотеку запрещено. Возможны и другие ошибки безопасности, но они указывают на ошибку подсистемы безопасности.
ERROR_ALREADY_RESERVED
 Этот слот или другой слот в библиотеке уже зарезервирован для очистки. Чтобы изменить слот для очистки, сначала необходимо освободить зарезервированный слот очистки с помощью функции ReleaseNtmsCleanerSlot .
ERROR_DEVICE_NOT_AVAILABLE
 Библиотека в настоящее время не подключена.
ERROR_INVALID_HANDLE
 Недопустимое значение, указанное в параметре hSession .
ERROR_INVALID_SLOT
 Не удалось получить определение слота из базы данных.
ERROR_NOT_CONNECTED
 Не удается подключиться к службе RSM.
ERROR_SLOT_FULL
 Слот для очистки не зарезервирован. В указанном слоте есть носитель. Резервирование может выполняться только в пустом слоте.
ERROR_SLOT_NOT_PRESENT
 Слот для очистки не зарезервирован. Указанный слот в настоящее время не установлен в библиотеке. Эта ошибка возникает, если в библиотеке отсутствует хотя бы один кассетный журнал.
ERROR_SUCCESS
 Функция успешно поставлена в очередь.

Комментарии

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

Требования

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

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

CleanNtmsDrive

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

EjectNtmsCleaner

InjectNtmsCleaner

ReleaseNtmsCleanerSlot