Поделиться через

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

  • Статья

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

Функция AccessNtmsLibraryDoor разблокирует дверь указанной библиотеки. Если библиотека занята, RSM помещает запрос в очередь и возвращается успешно.

Синтаксис

DWORD AccessNtmsLibraryDoor(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpLibraryId,
  [in] DWORD       dwAction
);

Параметры

[in] hSession

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

[in] lpLibraryId

Уникальный идентификатор объекта библиотеки. Эта библиотека должна поддерживать доступ к дверям.

[in] dwAction

Выполняемая операция. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
NTMS_INVENTORY_NONE
 После закрытия пользователем двери инвентаризация не выполняется. Однако при сбое проверка метки подключения будет выполнена инвентаризация.
NTMS_INVENTORY_OMID
 После закрытия пользователем двери выполняется полная инвентаризация на носителе. Это может занять много времени, так как каждая сторона каждого носителя должна быть подключена.
NTMS_INVENTORY_FAST
 Если в библиотеке установлено средство чтения штрихкода, этот флаг приводит к выполнению инвентаризации штрихового кода. Если в библиотеке нет средства чтения штрихового кода, этот флаг вызывает разностную инвентаризацию. OMID проверяются на каждом носителе, помещенном в пустой слот, пока дверь открыта.
NTMS_INVENTORY_DEFAULT
 Используйте InventoryMethod, указанный в объекте библиотеки (см. NTMS_LIBRARYINFORMATION).

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

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

Значение Значение
ERROR_ACCESS_DENIED
 NTMS_CONTROL_ACCESS в библиотеку запрещено. Возможны и другие ошибки безопасности, но они указывают на ошибку подсистемы безопасности.
ERROR_DATABASE_FAILURE
 База данных недоступна или повреждена.
ERROR_DATABASE_FULL
 База данных заполнена.
ERROR_INVALID_HANDLE
 Идентификатор сеанса отсутствует или недопустим.
ERROR_INVALID_PARAMETER
 Отсутствует идентификатор библиотеки.
ERROR_LIBRARY_OFFLINE
 Идентификатор библиотеки ссылается на автономную библиотеку без двери.
ERROR_NOT_ENOUGH_MEMORY
 Во время обработки произошел сбой выделения.
ERROR_RESOURCE_DISABLED
 Библиотека отключена.
ERROR_RESOURCE_NOT_PRESENT
 В библиотеке нет двери.
ERROR_SUCCESS
 Доступ к двери помещается в очередь.

Комментарии

Некоторые библиотеки не предоставляют rsm средств для программной блокировки и разблокировки своих дверей. Поведение этой функции с этими библиотеками идентично ее поведению с библиотеками, которые RSM может разблокировать и заблокировать.

Требования

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

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

EjectNtmsMedia

InjectNtmsMedia

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