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 |
---|---|
|
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. |
|
Auf die Datenbank kann nicht zugegriffen werden oder ist beschädigt. |
|
Die Datenbank ist voll. |
|
Das Sitzungshandle fehlt oder ist ungültig. |
|
Der Medienbezeichner ist ungültig. |
|
Der Medienpool für Medien ist ungültig. |
|
Der Medienbezeichner fehlt. |
|
Die Medien befinden sich nicht im Status Verfügbar. |
|
Während der Verarbeitung ist ein Zuordnungsfehler aufgetreten. |
|
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 |