DisableNtmsObject-Funktion (ntmsapi.h)

  • Artikel

[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