GetNtmsObjectInformationA-Funktion (ntmsapi.h)

  • Artikel

[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

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 an das Objekt oder dessen Container wird verweigert. Es sind auch andere Sicherheitsfehler möglich, die jedoch auf einen Fehler des Sicherheitssubsystems hindeuten.

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 Größe oder der Objekttyp der Objektinformationen 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 richtig 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 Member verantwortlich.

Im Folgenden ist die Liste der Objekte aufgeführt, die spezielle Zugriffsrechte erfordern.

Object Access
NTMS_CHANGER Erfordert NTMS_USE_ACCESS zur 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 zur Bibliothek.
NTMS_DRIVE_TYPE Erfordert NTMS_USE_ACCESS auf dem Computer.
NTMS_IEDOOR Erfordert NTMS_USE_ACCESS zur Bibliothek.
NTMS_IEPORT Erfordert NTMS_USE_ACCESS zur Bibliothek.
NTMS_LIBRARY Erfordert NTMS_USE_ACCESS zur Bibliothek.
NTMS_LIBREQUEST Erfordert NTMS_USE_ACCESS zur 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 zur Bibliothek.
 

Hinweis

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
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