GetNtmsObjectInformationA-Funktion (ntmsapi.h)
[Wechselmedien-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 GetNtmsObjectInformationA(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpObjectId,
[out] LPNTMS_OBJECTINFORMATIONA lpInfo
);
Parameter
[in] hSession
Behandeln Sie die sitzung, die von der OpenNtmsSession--Funktion zurückgegeben wird.
[in] lpObjectId
Eindeutiger Bezeichner des RSM-Objekts.
[out] lpInfo
Zeigen Sie 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 an das Objekt oder dessen Container wird verweigert. Andere Sicherheitsfehler sind ebenfalls möglich, weisen jedoch auf einen Sicherheitssubsystemfehler hin.
Windows XP: Es sind keine Zugriffsrechte erforderlich. |
|
Der 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. |
Bemerkungen
Die Informationsgröße und der Informationstyp der Informationsstruktur müssen im lpInfo- Parameter korrekt 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 dafür verantwortlich, einen Wert für alle beschreibbaren Member bereitzustellen.
Es folgt die Liste der Objekte, die spezielle Zugriffsrechte erfordern.
| Objekt | Zugang |
|---|---|
| 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 für den 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 für den Medienpool der Seite. |
| NTMS_PHYSICAL_MEDIA | Erfordert NTMS_USE_ACCESS für den Medienpool. |
| NTMS_STORAGESLOT | Erfordert NTMS_USE_ACCESS für die Bibliothek. |
Anmerkung
Der ntmsapi.h-Header definiert GetNtmsObjectInformation als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | ntmsapi.h |
| Library | Ntmsapi.lib |
| DLL- | Ntmsapi.dll |