GetNtmsObjectAttributeA-Funktion (ntmsapi.h)
[Wechselmedien-Manager ist ab Windows 7 und Windows Server 2008 R2 nicht mehr verfügbar.]
Die GetNtmsObjectAttribute--Funktion ruft das erweiterte Attribut (benannte private Daten) aus dem angegebenen RSM-Objekt ab.
Syntax
DWORD GetNtmsObjectAttributeA(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpObjectId,
[in] DWORD dwType,
[in] LPCSTR lpAttributeName,
[out] LPVOID lpAttributeData,
[in, out] LPDWORD lpAttributeSize
);
Parameter
[in] hSession
Behandeln Sie die sitzung, die von der OpenNtmsSession--Funktion zurückgegeben wird.
[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
Zeigen Sie auf den Puffer, der die Daten empfängt.
[in, out] lpAttributeSize
Größe des Datenpuffers für die Eingabe in Byte. Bei der Ausgabe die tatsächliche Größe der Daten in Byte.
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. |
|
Fehler bei der Datenbankabfrage oder Aktualisierung. |
|
Die Puffergröße ist nicht ordnungsgemäß angegeben. Die richtige Größe wird im parameter lpAttributeSize zurückgegeben. |
|
Der im hSession Parameter angegebene Wert ist NULL- oder ungültig. |
|
Der Zeiger ist NULL- oder ungültig. |
|
Es kann keine Verbindung mit dem RSM-Dienst hergestellt werden. |
|
Das angegebene Attribut wurde nicht gefunden. |
|
Die Funktion war erfolgreich. |
Bemerkungen
Die GetNtmsObjectAttribute--Funktion muss auf dem RSM-Server ausgeführt werden. Da der Puffer von Bytes zwischen Systemen unterschiedlicher Architekturen entmarstet wird, kann die Remoteausführung dieser Funktion zu unvorhersehbaren Ergebnissen führen.
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_POOL | Erfordert NTMS_USE_ACCESS für den 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 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 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 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 |