DisableNtmsObject-Funktion (ntmsapi.h)

Artikel
08/25/2023

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

Die DisableNtmsObject-Funktion deaktiviert das angegebene RSM-Objekt.

Syntax

DWORD DisableNtmsObject(
  [in] HANDLE      hSession,
  [in] DWORD       dwType,
  [in] LPNTMS_GUID lpObjectId
);

Parameter

[in] hSession

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

[in] dwType

RSM-Objekttyp. Dieser Parameter kann einer der folgenden Werte aus dem NtmsObjectsTypes-Enumerationstyp sein.

Wert	Bedeutung
NTMS_DRIVE	Laufwerk
NTMS_LIBRARY	Bibliothek
NTMS_PHYSICAL_MEDIA	Physische Medien (Band, optischer Datenträger, CD oder Magnetkassette)

[in] lpObjectId

Eindeutiger Bezeichner des RSM-Objekts.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS der Bibliothek, die das Objekt enthält, wird verweigert. Andere Sicherheitsfehler sind möglich, weisen jedoch auf einen Sicherheitssubsystemfehler hin. Windows XP: NTMS_CONTROL_ACCESS der Bibliothek, die das Objekt enthält, wird verweigert. Andere Sicherheitsfehler sind möglich, weisen jedoch auf einen Sicherheitssubsystemfehler 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_PARAMETER	Eine Objekt-ID fehlt, oder der Objekttyp ist ungültig. (Der Objekttyp ist ungültig, wenn er nicht NTMS_LIBRARY, NTMS_DRIVE oder NTMS_PHYSICAL_MEDIA ist.)
ERROR_INVALID_STATE	Das Objekt ist bereits deaktiviert.
ERROR_LIBRARY_OFFLINE	Die Bibliotheks-ID bezieht sich auf eine Offlinebibliothek, die nicht aktiviert oder deaktiviert werden kann.
ERROR_OBJECT_NOT_FOUND	Das Objekt ist nicht gültig.
ERROR_SUCCESS	Die Deaktivierung wird in eine Warteschlange eingereiht.

Hinweise

Die DisableNtmsObject-Funktion stellt einen Disable-Befehl für das angegebene Objekt in die Warteschlange. Die Funktion wird erfolgreich zurückgegeben, wenn der Befehl in die Warteschlange gestellt wird. Wenn RSM ausgelastet ist, kann der Abschluss des Befehls einige Zeit in Anspruch nehmen. Wenn das Medium deaktiviert ist, rendert RSM alle Seiten des Mediums und die zugeordneten logischen Medien nicht verfügbar. Alle Anforderungen an deaktivierte Medien geben Fehler zurück.

Um ein Laufwerk oder einen Medienwechser aus dem Dienst zu entfernen, muss zuerst der Laufwerks- oder Medienwechsierer deaktiviert werden.

Alle Objekte, die in einem deaktivierten Objekt enthalten sind, sind ebenfalls deaktiviert. Wenn Sie beispielsweise einen Teil physischer Medien deaktivieren, werden alle Seiten deaktiviert. Wenn ein Laufwerk deaktiviert ist, wird das Medium im Laufwerk nach Möglichkeit entfernt und in seinem Steckplatz platziert.

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

EnableNtmsObject

Objektverwaltungsfunktionen

Freigeben über