GetNtmsObjectAttributeW-Funktion (ntmsapi.h)

  • Artikel

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

Die GetNtmsObjectAttribute-Funktion ruft das erweiterte Attribut (private Daten) aus dem angegebenen RSM-Objekt ab.

Syntax

DWORD GetNtmsObjectAttributeW(
  [in]      HANDLE      hSession,
  [in]      LPNTMS_GUID lpObjectId,
  [in]      DWORD       dwType,
  [in]      LPCWSTR     lpAttributeName,
  [out]     LPVOID      lpAttributeData,
  [in, out] LPDWORD     lpAttributeSize
);

Parameter

[in] hSession

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

[in] lpObjectId

Eindeutiger Bezeichner des Objekts, aus dem die Daten abgerufen werden sollen.

[in] dwType

RSM-Objekttyp. Eine Liste der Objekttypen finden Sie unter NtmsObjectsTypes.

[in] lpAttributeName

Name des erweiterten Attributs, dessen Daten abgerufen werden sollen.

[out] lpAttributeData

Zeiger auf den Puffer, der die Daten empfängt.

[in, out] lpAttributeSize

Größe des Datenpuffers bei der Eingabe in Bytes. Bei der Ausgabe die tatsächliche Größe der Daten in Bytes.

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_DATABASE_FAILURE
 Fehler bei der Datenbankabfrage oder -aktualisierung.
ERROR_INSUFFICIENT_BUFFER
 Die Puffergröße wird nicht ordnungsgemäß angegeben. Die richtige Größe wird im lpAttributeSize-Parameter zurückgegeben.
ERROR_INVALID_HANDLE
 Der im hSession-Parameter angegebene Wert ist NULL oder ungültig.
ERROR_INVALID_PARAMETER
 Der Zeiger ist NULL oder ungültig.
ERROR_NOT_CONNECTED
 Es kann keine Verbindung mit dem RSM-Dienst hergestellt werden.
ERROR_OBJECT_NOT_FOUND
 Das angegebene Attribut wurde nicht gefunden.
ERROR_SUCCESS
 Die Funktion war erfolgreich.

Hinweise

Die GetNtmsObjectAttribute-Funktion muss auf dem RSM-Server ausgeführt werden. Da der Bytespuffer zwischen Systemen unterschiedlicher Architekturen nicht miteinander synchronisiert wird, kann die Remoteausführung dieser Funktion zu unvorhersehbaren Ergebnissen führen.

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_POOL Erfordert NTMS_USE_ACCESS zum Medienpool.
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.
 

Hinweis

Der ntmsapi.h-Header definiert GetNtmsObjectAttribute als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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

EnumerateNtmsObject

Objektverwaltungsfunktionen

SetNtmsObjectAttribute