GetNtmsObjectInformation-Funktion (ntmsapi.h)

[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