Share via

EnableNtmsObject-Funktion (ntmsapi.h)

  • Artikel

[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