Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[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 |
|---|---|
|
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. |
|
Das Sitzungshandle fehlt oder ist ungültig. |
|
Die Objekt-ID oder Informationsstruktur fehlt, oder die Objektinformationsgröße oder der Objekttyp ist ungültig. |
|
Während der Verarbeitung ist ein Zuordnungsfehler aufgetreten. |
|
Die Objekt-ID ist ungültig. |
|
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 |