Freigeben über


DeleteNtmsLibrary-Funktion (ntmsapi.h)

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

Die DeleteNtmsLibrary-Funktion löscht eine Bibliothek und alle in der Bibliothek enthaltenen Geräte aus der RSM-Datenbank. Alle Medien in der Bibliothek werden in die Offlinebibliothek verschoben.

Syntax

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

Parameter

[in] hSession

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

[in] lpLibraryId

Eindeutiger Bezeichner der zu löschenden Bibliothek.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert Bedeutung
ERROR_ACCESS_DENIED
NTMS_MODIFY_ACCESS der Bibliothek wird verweigert. Es sind auch andere Sicherheitsfehler möglich, die jedoch auf einen Sicherheitssubsystemfehler hinweisen würden.
ERROR_DATABASE_FAILURE
Auf die Datenbank kann nicht zugegriffen werden oder ist beschädigt.
ERROR_DATABASE_FULL
Die Datenbank ist voll.
ERROR_INVALID_HANDLE
Das Sitzungshandle fehlt oder ist ungültig.
ERROR_INVALID_LIBRARY
Der Bibliotheksbezeichner ist ungültig.
ERROR_INVALID_PARAMETER
Es fehlt ein Medienbezeichner.
ERROR_NOT_ENOUGH_MEMORY
Während der Verarbeitung ist ein Zuordnungsfehler aufgetreten.
ERROR_SUCCESS
Die Funktion war erfolgreich.

Hinweise

Wenn die Bibliothek, auf die von der DeleteNtmsLibrary-Funktion verwiesen wird, Medien enthält, wird das Medium in die Offlinebibliothek verschoben.

Sie können DeleteNtmsLibrary verwenden, um Bibliotheken zu entfernen, die nicht mehr mit dem RSM-Server verbunden 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

Bibliothekssteuerungsfunktionen