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

структура NTMS_LIBRARYINFORMATION (ntmsapi.h)

  • Статья

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

Структура NTMS_LIBRARYINFORMATION определяет свойства, относящиеся к объекту библиотеки.

Синтаксис

typedef struct _NTMS_LIBRARYINFORMATION {
  DWORD     LibraryType;
  NTMS_GUID CleanerSlot;
  NTMS_GUID CleanerSlotDefault;
  BOOL      LibrarySupportsDriveCleaning;
  BOOL      BarCodeReaderInstalled;
  DWORD     InventoryMethod;
  DWORD     dwCleanerUsesRemaining;
  DWORD     FirstDriveNumber;
  DWORD     dwNumberOfDrives;
  DWORD     FirstSlotNumber;
  DWORD     dwNumberOfSlots;
  DWORD     FirstDoorNumber;
  DWORD     dwNumberOfDoors;
  DWORD     FirstPortNumber;
  DWORD     dwNumberOfPorts;
  DWORD     FirstChangerNumber;
  DWORD     dwNumberOfChangers;
  DWORD     dwNumberOfMedia;
  DWORD     dwNumberOfMediaTypes;
  DWORD     dwNumberOfLibRequests;
  GUID      Reserved;
  BOOL      AutoRecovery;
  DWORD     dwFlags;
} NTMS_LIBRARYINFORMATION;

Члены

LibraryType

Объект типа библиотеки. Это может быть одно из следующих значений.

Значение Значение
NTMS_LIBRARYTYPE_ONLINE
 Роботизированный элемент, автоматизируя установку и отключение носителя на одном или нескольких дисках.
NTMS_LIBRARYTYPE_STANDALONE
 Автономный диск, смоделируемый как библиотека с одним диском в RSM.
NTMS_LIBRARYTYPE_OFFLINE
 Носитель, который не находится в библиотеке, находится в автономной библиотеке.
NTMS_LIBRARYTYPE_UNKNOWN
 Не удается определить тип библиотеки.

CleanerSlot

Для каждой библиотеки это слот, назначенный для более чистого патрона. Если этот член имеет значение NULL, для этой библиотеки не определен более чистый слот.

CleanerSlotDefault

Представляет стандартный или предпочтительный слот очистки библиотек. Если значение РАВНО NULL, нет предпочтительного слота.

LibrarySupportsDriveCleaning

Используется дисками, которые требуют очистки под контролем робототехники. Если задано значение TRUE, автоматические операции очистки диска включены.

BarCodeReaderInstalled

Возвращает значение TRUE , если средство чтения штрихкода установлено в библиотеке; в противном случае возвращает значение FALSE.

InventoryMethod

Метод по умолчанию или выбранный пользователем метод для инвентаризации этой библиотеки. (Этот элемент доступен для записи.) Это может быть одно из следующих значений.

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

dwCleanerUsesRemaining

Количество применений, оставшихся в средстве очистки в библиотеке. Этот элемент равен нулю, если очистка отсутствует или библиотека не поддерживает очистку.

FirstDriveNumber

Номер первого диска в библиотеке.

dwNumberOfDrives

Количество дисков в библиотеке.

FirstSlotNumber

Номер первого слота в библиотеке.

dwNumberOfSlots

Количество слотов в библиотеке.

FirstDoorNumber

Номер первой двери доступа в библиотеке.

dwNumberOfDoors

Количество дверей доступа в библиотеке.

FirstPortNumber

Номер первого порта вставки или извлечения в библиотеке.

dwNumberOfPorts

Количество портов вставки и извлечения в библиотеке.

FirstChangerNumber

Номер первого преобновителя в библиотеке.

dwNumberOfChangers

Количество средств изменения в библиотеке.

dwNumberOfMedia

Число носителей в сетевой или автономной библиотеке.

dwNumberOfMediaTypes

Количество типов носителей, поддерживаемых библиотекой.

dwNumberOfLibRequests

Число текущих запросов библиотеки.

Reserved

Зарезервировано.

AutoRecovery

Если этот элемент имеет значение TRUE, в случае сбоя подключения будет выполнена полная инвентаризация. Это может быть несоответствие оборудования или меток. Для библиотек CD ATAPI этот параметр нельзя отключить. Значение по умолчанию — TRUE. Владельцы больших библиотек должны отключить эту функцию.

dwFlags

Этот элемент может быть одним или несколькими из следующих значений.

Значение Значение
NTMS_LIBRARYFLAG_FIXEDOFFLINE
 Библиотека является автономной, а не библиотекой, которая отсутствует.
NTMS_LIBRARYFLAG_CLEANERPRESENT
 В средстве смены присутствует средство очистки.
NTMS_LIBRARYFLAG_IGNORECLEANERUSESREMAINING
 Очиститель будет использоваться до тех пор, пока он больше не очищает диск, вместо того, чтобы отслеживать количество оставшихся очистки. Не устанавливайте этот флаг напрямую. Он задается или очищается на основе значения dwCleanerUsesRemaining. Устанавливается, если параметр dwCleanerUsesRemaining 0xFFFFFFFF, а в противном случае удаляется.
NTMS_LIBRARYFLAG_RECOGNIZECLEANERBARCODE
 Рассматривайте кассеты со штрихкодами, которые имеют CLN в качестве префикса, как более чистые патроны, а не монтируйте их в диск для их идентификации.

Комментарии

Для автономных библиотек отображаются только LibraryType и dwNumberOfMedia . Все остальные значения следует игнорировать.

Структура NTMS_LIBRARYINFORMATION включена в структуру NTMS_OBJECTINFORMATION .

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть ntmsapi.h

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

NTMS_OBJECTINFORMATION