NTMS_LIBRARYINFORMATION-Struktur (ntmsapi.h)

Artikel
08/25/2023

[Wechseldatenträger-Manager ist ab Windows 7 und Windows Server 2008 R2 nicht mehr verfügbar.]

Die NTMS_LIBRARYINFORMATION-Struktur definiert Eigenschaften, die für ein Bibliotheksobjekt spezifisch sind.

Syntax

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;

Member

LibraryType

Bibliothekstypobjekt. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
NTMS_LIBRARYTYPE_ONLINE	Ein Roboterelement, das das Ein- und Aushängen von Medien in einem oder mehreren Laufwerken automatisiert.
NTMS_LIBRARYTYPE_STANDALONE	Ein eigenständiges Laufwerk, das als Bibliothek mit einem Laufwerk in RSM modelliert ist.
NTMS_LIBRARYTYPE_OFFLINE	Medien, die sich nicht in einer Bibliothek befinden, befinden sich in der Offlinebibliothek.
NTMS_LIBRARYTYPE_UNKNOWN	Der Bibliothekstyp kann nicht bestimmt werden.

CleanerSlot

Für jede Bibliothek stellt dies den Steckplatz dar, der der Kassette mit Reiniger zugewiesen wurde. Wenn dieser Member NULL ist, ist kein saubererer Slot für diese Bibliothek definiert.

CleanerSlotDefault

Stellt den standardmäßigen oder bevorzugten Cleaner-Slot einer Bibliothek dar. Bei NULL ist kein bevorzugter Slot vorhanden.

LibrarySupportsDriveCleaning

Wird von Antrieben verwendet, die unter Robotersteuerung gereinigt werden müssen. Wenn TRUE, sind automatische Laufwerksreinigungsvorgänge aktiviert.

BarCodeReaderInstalled

Gibt TRUE zurück, wenn ein Barcodeleser in einer Bibliothek installiert ist. gibt andernfalls FALSE zurück.

InventoryMethod

Standardmethode oder vom Benutzer ausgewählte Methode für die Inventur dieser Bibliothek. (Dieses Element ist beschreibbar.) Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
NTMS_INVENTORY_FAST	Wenn in der Bibliothek ein Barcodeleser installiert ist, wird mit diesem Wert eine Barcodeinventur durchgeführt. Wenn die Bibliothek über keinen Barcodeleser verfügt, bewirkt dieses Flag, dass eine differenzielle Inventur ausgeführt wird (Slots, die von leer zu voll übergehen, werden klassifiziert).
NTMS_INVENTORY_OMID	Eine vollständige Inventur umfasst das Einbinden jeder Seite in einer Bibliothek und das Lesen der On-Media-Identifikation aus den Medien. Diese Art von Inventar kann für einige Bibliothekseinheiten sehr zeitaufwändig sein.
NTMS_INVENTORY_NONE	Nachdem die Bibliothekstür geschlossen wurde, wird keine Inventur durchgeführt. Die Inventur kann erforderlich sein, wenn bei der Überprüfung der Einbindungsbezeichnung ein Fehler auftritt.

dwCleanerUsesRemaining

Anzahl der verbleibenden Verwendungen für den Cleaner in der Bibliothek. Dieser Member ist 0, wenn kein Cleaner vorhanden ist oder wenn die Bibliothek keine Reinigung unterstützt.

FirstDriveNumber

Nummer des ersten Laufwerks in der Bibliothek.

dwNumberOfDrives

Anzahl der Laufwerke in der Bibliothek.

FirstSlotNumber

Nummer des ersten Slots in der Bibliothek.

dwNumberOfSlots

Anzahl der Slots in der Bibliothek.

FirstDoorNumber

Nummer der ersten Zugangstür in der Bibliothek.

dwNumberOfDoors

Anzahl der Zugangstüren in der Bibliothek.

FirstPortNumber

Nummer des ersten Einfüge-/Auswurfports in der Bibliothek.

dwNumberOfPorts

Anzahl der Ein-/Auswurfports in der Bibliothek.

FirstChangerNumber

Nummer des ersten Changers in der Bibliothek.

dwNumberOfChangers

Anzahl der Änder in der Bibliothek.

dwNumberOfMedia

Anzahl der Medien in der Online- oder Offlinebibliothek.

dwNumberOfMediaTypes

Anzahl der von der Bibliothek unterstützten Medientypen.

dwNumberOfLibRequests

Anzahl der aktuellen Bibliotheksanforderungen.

Reserved

Reserviert.

AutoRecovery

Wenn dieser Member TRUE ist, wird eine vollständige Inventarisierung durchgeführt, wenn eine Bereitstellung fehlschlägt. Der Fehler kann entweder hardware- oder bezeichnungswidrig sein. Für ATAPI-CD-Bibliotheken kann dieser Parameter nicht deaktiviert werden. Der Standardwert ist TRUE. Besitzer großer Bibliotheken sollten dieses Feature deaktivieren.

dwFlags

Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln.

Wert	Bedeutung
NTMS_LIBRARYFLAG_FIXEDOFFLINE	Die Bibliothek ist eine Offlinebibliothek, keine Bibliothek, die nicht vorhanden ist.
NTMS_LIBRARYFLAG_CLEANERPRESENT	Ein Reiniger ist in der Umwechslung vorhanden.
NTMS_LIBRARYFLAG_IGNORECLEANERUSESREMAINING	Die Reinigerkartusche wird verwendet, bis sie das Laufwerk nicht mehr reinigt, anstatt die Anzahl der Nochreinigungen zu verfolgen. Legen Sie dieses Flag nicht direkt fest. Sie wird basierend auf dem Wert von dwCleanerUsesRemaining festgelegt oder gelöscht. Sie wird festgelegt, wenn dwCleanerUsesRemaining 0xFFFFFFFF und andernfalls gelöscht wird.
NTMS_LIBRARYFLAG_RECOGNIZECLEANERBARCODE	Behandeln Sie Strichcodekartuschen mit CLN als Präfix als sauberere Patronen, anstatt sie im Laufwerk zu montieren, um sie zu identifizieren.

Hinweise

Für Offlinebibliotheken werden nur LibraryType und dwNumberOfMedia gemeldet. Alle anderen Werte sollten ignoriert werden.

Die NTMS_LIBRARYINFORMATION-Struktur ist in der NTMS_OBJECTINFORMATION-Struktur enthalten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	ntmsapi.h

Weitere Informationen

NTMS_OBJECTINFORMATION

Freigeben über