InventoryNtmsLibrary-Funktion (ntmsapi.h)

Artikel
03/04/2024

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

Die Funktion InventoryNtmsLibrary stellt ein Inventar der angegebenen Bibliothek in die Warteschlange. Wenn die Bibliothek ausgelastet ist, stellt RSM InventoryNtmsLibrary in die Warteschlange und gibt den Erfolg zurück.

Syntax

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

Parameter

[in] hSession

Handle für die von der OpenNtmsSession-Funktion zurückgegebene Sitzung.

[in] lpLibraryId

Eindeutiger Bezeichner eines Bibliotheksobjekts.

[in] dwAction

Auszuführende Aktion. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
NTMS_INVENTORY_OMID	Eine vollständige Medieninventur wird durchgeführt. Jede Seite jedes Mediums muss in ein Laufwerk eingebunden werden. Dies ist ein zeitaufwändiger Prozess.
NTMS_INVENTORY_FAST	Wenn in der Bibliothek ein Barcodeleser installiert ist, bewirkt dieses Flag, dass eine Barcodeinventur durchgeführt wird. Wenn die Bibliothek über keinen Barcodeleser verfügt, bewirkt dieses Flag, dass eine differenzielle Inventur durchgeführt wird (Slots werden klassifiziert).
NTMS_INVENTORY_DEFAULT	Verwenden Sie die im Bibliotheksobjekt angegebene InventoryMethod (siehe NTMS_LIBRARYINFORMATION).
NTMS_INVENTORY_STOP	Beenden Sie den aktuellen Bestand in der angegebenen Bibliothek.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	Der Zugriff auf ein oder mehrere RSM-Objekte wird verweigert.
ERROR_DEVICE_NOT_AVAILABLE	Die Bibliothek ist derzeit nicht verbunden.
ERROR_INVALID_HANDLE	Der im hSession-Parameter angegebene Wert ist ungültig.
ERROR_INVALID_LIBRARY	Die Bibliothek ist die Offlinebibliothek.
ERROR_INVALID_PARAMETER	Die Bibliotheks-ID oder Sitzungs-ID ist ungültig.
ERROR_NOT_CONNECTED	Es kann keine Verbindung mit dem RSM-Dienst hergestellt werden.
ERROR_SUCCESS	Die Funktion war erfolgreich.

Hinweise

Nicht vorhandene Bibliotheken können nicht inventarisiert werden.

Die InventoryNtmsLibrary-Funktion markiert alle Slots, die derzeit ein Medium in der Bibliothek für die Klassifizierung/Identifizierung enthalten. Die InventoryNtmsLibrary-Funktion gibt zurück, wenn alle Medien markiert sind.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ntmsapi.h
Bibliothek	Ntmsapi.lib
DLL	Ntmsapi.dll

Weitere Informationen

AccessNtmsLibraryDoor

Bibliothekssteuerungsfunktionen

Freigeben über