DeleteNtmsMediaPool-Funktion (ntmsapi.h)

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

Die DeleteNtmsMediaPool-Funktion löscht den angegebenen Anwendungsmedienpool.

Syntax

DWORD DeleteNtmsMediaPool(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpPoolId
);

[in] hSession

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

[in] lpPoolId

Eindeutiger Bezeichner des Medienpools.

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS zum Medienpool wird verweigert. Andere Sicherheitsfehler sind ebenfalls möglich, weisen jedoch auf einen Fehler des Sicherheitssubsystems hin. Windows XP: NTMS_CONTROL_ACCESS zum Medienpool wird verweigert. Andere Sicherheitsfehler sind ebenfalls möglich, weisen jedoch auf einen Fehler des Sicherheitssubsystems hin.
ERROR_DATABASE_FAILURE	Auf die Datenbank kann nicht zugegriffen werden oder ist beschädigt.
ERROR_INVALID_HANDLE	Das Sitzungshandle fehlt oder ist ungültig.
ERROR_INVALID_MEDIA_POOL	Ein vorhandener Medienpool kann nicht geöffnet werden, oder es kann nicht versucht werden, freie, importierte oder nicht erkannte Medienpools zu löschen.
ERROR_INVALID_PARAMETER	Die Medienpool-ID fehlt.
ERROR_NOT_EMPTY	Der Medienpool muss leer sein, um gelöscht zu werden.
ERROR_NOT_ENOUGH_MEMORY	Während der Verarbeitung ist ein Zuordnungsfehler aufgetreten.
ERROR_SUCCESS	Die Funktion war erfolgreich.

Nur leere Medienpools können mit der DeleteNtmsMediaPool-Funktion gelöscht werden.

Kostenlose, nicht erkannte und importierte Medienpools werden von RSM verwaltet und können nicht mit DeleteNtmsMediaPool gelöscht werden.

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