AccessNtmsLibraryDoor-Funktion (ntmsapi.h)

Artikel
03/06/2024

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

Die AccessNtmsLibraryDoor-Funktion entsperrt die Tür der angegebenen Bibliothek. Wenn die Bibliothek ausgelastet ist, stellt RSM die Anforderung in die Warteschlange und gibt erfolgreich zurück.

Syntax

DWORD AccessNtmsLibraryDoor(
  [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 des Bibliotheksobjekts. Diese Bibliothek muss den Türzugriff unterstützen.

[in] dwAction

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

Wert	Bedeutung
NTMS_INVENTORY_NONE	Nachdem der Benutzer die Tür geschlossen hat, wird keine Inventur durchgeführt. Wenn jedoch eine Mount-Label-Überprüfung fehlschlägt, wird eine Inventur durchgeführt.
NTMS_INVENTORY_OMID	Nachdem der Benutzer die Tür geschlossen hat, wird eine vollständige Medieninventur durchgeführt. Dies kann zeitaufwendig sein, da jede Seite jedes Mediums eingebunden werden muss.
NTMS_INVENTORY_FAST	Wenn in der Bibliothek ein Barcodeleser installiert ist, bewirkt dieses Flag, dass eine Barcodeinventur durchgeführt wird. Wenn die Bibliothek nicht über einen Barcodeleser verfügt, bewirkt dieses Flag, dass eine differenzielle Inventur durchgeführt wird. Die OMIDs werden auf jedem Medium überprüft, das sich in einem leeren Slot befindet, während die Tür geöffnet ist.
NTMS_INVENTORY_DEFAULT	Verwenden Sie die im Bibliotheksobjekt angegebene InventoryMethod (siehe NTMS_LIBRARYINFORMATION).

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS der Bibliothek wird verweigert. Es sind auch andere Sicherheitsfehler möglich, die jedoch auf einen Fehler des Sicherheitssubsystems hindeuten.
ERROR_DATABASE_FAILURE	Auf die Datenbank kann nicht zugegriffen werden oder beschädigt werden.
ERROR_DATABASE_FULL	Die Datenbank ist voll.
ERROR_INVALID_HANDLE	Die Sitzungs-ID fehlt oder ist ungültig.
ERROR_INVALID_PARAMETER	Die Bibliotheks-ID fehlt.
ERROR_LIBRARY_OFFLINE	Die Bibliotheks-ID verweist auf eine Offlinebibliothek ohne Tür.
ERROR_NOT_ENOUGH_MEMORY	Während der Verarbeitung ist ein Zuordnungsfehler aufgetreten.
ERROR_RESOURCE_DISABLED	Die Bibliothek ist deaktiviert.
ERROR_RESOURCE_NOT_PRESENT	Die Bibliothek verfügt nicht über eine Tür.
ERROR_SUCCESS	Der Türzugriff wird in die Warteschlange eingereiht.

Hinweise

Einige Bibliotheken bieten keine Möglichkeit für RSM, ihre Türen programmgesteuert zu sperren und zu entsperren. Das Verhalten dieser Funktion mit diesen Bibliotheken ist identisch mit dem Verhalten mit Bibliotheken, die RSM entsperren und sperren kann.

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

EjectNtmsMedia

InjectNtmsMedia

Bibliothekssteuerungsfunktionen

Freigeben über