Freigeben über


AußerbetriebnahmeNtmsMedia-Funktion (ntmsapi.h)

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

Die Funktion DecommissionNtmsMedia verschiebt eine Seite vom Status Verfügbar in den Zustand Außer Betrieb gesetzt.

Syntax

DWORD DecommissionNtmsMedia(
  [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 einer Seite eines Stücks physischer Medien.

Rückgabewert

Wert Bedeutung
ERROR_ACCESS_DENIED
NTMS_CONTROL_ACCESS zum Medienpool der Medien 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 Medien ist ungültig.
ERROR_INVALID_PARAMETER
Der Medienbezeichner fehlt.
ERROR_INVALID_STATE
Die Medien befinden sich nicht im Status Verfügbar.
ERROR_NOT_ENOUGH_MEMORY
Während der Verarbeitung ist ein Zuordnungsfehler aufgetreten.
ERROR_SUCCESS
Die Funktion war erfolgreich.

Hinweise

Medien, die von der Funktion DecommissionNtmsMedia außer Betrieb genommen wurden, werden von RSM erkannt, aber die außer Betrieb genommenen Medien enthalten keine Daten und werden nie wieder verwendet.

Nur Medien, die den Status Verfügbar haben, können außer Betrieb genommen werden. Weitere Informationen finden Sie unter Medienlebenszyklus.

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

AllocateNtmsMedia

Media Services-Funktionen