DeleteNtmsMedia-Funktion (ntmsapi.h)

  • Artikel

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

Die DeleteNtmsMedia-Funktion löscht einen physischen Teil von Offlinemedien aus RSM, indem alle Verweise auf die angegebenen Medien aus der Datenbank entfernt werden.

Syntax

DWORD DeleteNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId
);

Parameter

[in] hSession

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

[in] lpMediaId

Eindeutiger Bezeichner eines Physischen Medienteils.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert Bedeutung
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS an den Computer oder den Medienpool des Mediums wird verweigert. Es sind auch andere Sicherheitsfehler möglich, die jedoch auf einen Sicherheitssubsystemfehler hinweisen würden.

Windows XP: NTMS_MODIFY_ACCESS zum Medienpool der Medien 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_MEDIA
 Der Medienbezeichner ist ungültig.
ERROR_INVALID_MEDIA_POOL
 Der Medienpool für die Medien ist ungültig.
ERROR_INVALID_PARAMETER
 Der Medienbezeichner fehlt.
ERROR_INVALID_STATE
 Die Medien sind nicht offline.
ERROR_NOT_ENOUGH_MEMORY
 Während der Verarbeitung ist ein Zuordnungsfehler aufgetreten.
ERROR_SUCCESS
 Die Funktion war erfolgreich.

Hinweise

Medien, die von der DeleteNtmsMedia-Funktion angegeben werden, müssen sich in einer Offlinebibliothek befinden und dürfen keine Seite im Status "Zugeordnet", "Abgeschlossen" oder "Reserviert" aufweisen.

Sie können DeleteNtmsMedia verwenden, um verlorene oder zerstörte Medien zu entfernen.

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

Media Services-Funktionen