EnableNtmsObject-Funktion (ntmsapi.h)

Artikel
08/25/2023

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

Die EnableNtmsObject-Funktion aktiviert das angegebene Objekt.

Syntax

DWORD EnableNtmsObject(
  [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 Magnetplattenkassette)

[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	Die 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 aktiviert.
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 Aktivierung befindet sich in einer Warteschlange.

Hinweise

Die Funktion EnableNtmsObject stellt einen Disable-Befehl mit RSM in die Warteschlange. Wenn RSM ausgelastet ist, kann der Abschluss des Befehls einige Zeit in Anspruch nehmen.

Anforderungen


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

DisableNtmsObject

Objektverwaltungsfunktionen

Freigeben über