GetNtmsObjectInformation-Funktion (ntmsapi.h)

  • Artikel

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

Die GetNtmsObjectInformation-Funktion gibt die Informationsstruktur eines Objekts für das angegebene Objekt zurück.

Syntax

DWORD GetNtmsObjectInformation(
  [in]  HANDLE                   hSession,
  [in]  LPNTMS_GUID              lpObjectId,
  [out] LPNTMS_OBJECTINFORMATION lpInfo
);

Parameter

[in] hSession

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

[in] lpObjectId

Eindeutiger Bezeichner des RSM-Objekts.

[out] lpInfo

Zeiger auf eine NTMS_OBJECTINFORMATION-Struktur , die die Objektinformationen empfängt.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert Bedeutung
ERROR_ACCESS_DENIED
 NTMS_USE_ACCESS dem Objekt oder seinem Container wird verweigert. Es sind auch andere Sicherheitsfehler möglich, die jedoch auf einen Sicherheitssubsystemfehler hinweisen würden.

Windows XP: Es sind keine Zugriffsrechte erforderlich.
ERROR_INVALID_HANDLE
 Das Sitzungshandle fehlt oder ist ungültig.
ERROR_INVALID_PARAMETER
 Die Objekt-ID oder Informationsstruktur fehlt, oder die Objektinformationsgröße oder der Objekttyp ist ungültig.
ERROR_NOT_ENOUGH_MEMORY
 Während der Verarbeitung ist ein Zuordnungsfehler aufgetreten.
ERROR_OBJECT_NOT_FOUND
 Die Objekt-ID ist ungültig.
ERROR_SUCCESS
 Die Funktion war erfolgreich.

Hinweise

Die Informationsgröße und der Typ der Informationsstruktur müssen im lpInfo-Parameter ordnungsgemäß festgelegt werden, bevor Sie die GetNtmsObjectInformation-Funktion verwenden.

Um unvorhersehbare Ergebnisse zu vermeiden, müssen Anwendungen die GetNtmsObjectInformation-Funktion aufrufen, bevor sie die SetNtmsObjectInformation-Funktion aufrufen. Die SetNtmsObjectInformation-Funktion aktualisiert alle beschreibbaren Member der NTMS_OBJECTINFORMATION-Struktur . Daher ist die Anwendung für die Bereitstellung eines Werts für alle beschreibbaren Elemente verantwortlich.

Im Folgenden ist die Liste der Objekte aufgeführt, für die spezielle Zugriffsrechte erforderlich sind.

Object Access
NTMS_CHANGER Erfordert NTMS_USE_ACCESS für die Bibliothek.
NTMS_CHANGER_TYPE Erfordert NTMS_USE_ACCESS auf dem Computer.
NTMS_COMPUTER Erfordert NTMS_USE_ACCESS auf dem Computer.
NTMS_DRIVE Erfordert NTMS_USE_ACCESS für die Bibliothek.
NTMS_DRIVE_TYPE Erfordert NTMS_USE_ACCESS auf dem Computer.
NTMS_IEDOOR Erfordert NTMS_USE_ACCESS für die Bibliothek.
NTMS_IEPORT Erfordert NTMS_USE_ACCESS für die Bibliothek.
NTMS_LIBRARY Erfordert NTMS_USE_ACCESS für die Bibliothek.
NTMS_LIBREQUEST Erfordert NTMS_USE_ACCESS für die Bibliothek.
NTMS_LOGICAL_MEDIA Erfordert NTMS_USE_ACCESS zum Medienpool der logischen Medien.
NTMS_MEDIA_TYPE Erfordert NTMS_USE_ACCESS auf dem Computer.
NTMS_OPREQUEST Erfordert NTMS_USE_ACCESS auf dem Computer.
NTMS_PARTITION Erfordert NTMS_USE_ACCESS zum Medienpool der Seite.
NTMS_PHYSICAL_MEDIA Erfordert NTMS_USE_ACCESS zum Medienpool.
NTMS_STORAGESLOT Erfordert NTMS_USE_ACCESS für die Bibliothek.

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

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

Objektverwaltungsfunktionen

SetNtmsObjectInformation