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

  • Статья

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

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

Синтаксис

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

Параметры

[in] hSession

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

[in] lpLibraryId

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

[in] dwAction

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

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

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

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

Значение Значение
ERROR_ACCESS_DENIED
 Доступ к одному или нескольким объектам RSM запрещен.
ERROR_DEVICE_NOT_AVAILABLE
 Библиотека в настоящее время не подключена.
ERROR_INVALID_HANDLE
 Недопустимое значение, указанное в параметре hSession .
ERROR_INVALID_LIBRARY
 Библиотека является автономной библиотекой.
ERROR_INVALID_PARAMETER
 Недопустимый идентификатор библиотеки или сеанса.
ERROR_NOT_CONNECTED
 Не удается подключиться к службе RSM.
ERROR_SUCCESS
 Функция выполнена успешно.

Комментарии

Несущая библиотека не может быть инвентаризованной.

Функция InventoryNtmsLibrary помечает все слоты, которые в настоящее время содержат среду в библиотеке для классификации или идентификации. Функция InventoryNtmsLibrary возвращает значение, когда помечены все носители.

Требования

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

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

AccessNtmsLibraryDoor

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