SetNtmsObjectAttributeW-Funktion (ntmsapi.h)

Artikel
11/20/2024

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

Die SetNtmsObjectAttribute--Funktion erstellt ein erweitertes Attribut (benannte private Daten) im angegebenen RSM-Objekt.

Syntax

DWORD SetNtmsObjectAttributeW(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpObjectId,
  [in] DWORD       dwType,
  [in] LPCWSTR     lpAttributeName,
  [in] LPVOID      lpAttributeData,
       DWORD       AttributeSize
);

Parameter

[in] hSession

Behandeln Sie die sitzung, die von der OpenNtmsSession--Funktion zurückgegeben wird.

[in] lpObjectId

GUID des RSM-Objekts, für das das erweiterte Attribut erstellt werden soll.

[in] dwType

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

[in] lpAttributeName

Name des zu erstellenden erweiterten Attributs.

[in] lpAttributeData

Benutzerdefinierte Daten.

AttributeSize

Größe des lpAttributeData- Puffers in Byte. D

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS dem Objekt verweigert wird oder keine Änderungen für den angegebenen Objekttyp zulässig sind (siehe Hinweise). Andere Sicherheitsfehler sind ebenfalls möglich, weisen jedoch auf einen Sicherheitssubsystemfehler hin. Windows XP: Es sind keine Zugriffsrechte erforderlich.
ERROR_DATABASE_FAILURE	Fehler beim Aktualisieren der Datenbank.
ERROR_INVALID_HANDLE	Der im hSession Parameter angegebene Wert ist NULL- oder ungültig.
ERROR_INVALID_NAME	Der Name oder das Attribut ist ungültig. Der wert NTMS_MAXATTR_NAMELEN definiert die maximale Länge des Attributnamens. Die Länge enthält eine NULL-.
ERROR_INVALID_PARAMETER	Der Zeiger ist NULL- oder ungültig.
ERROR_NO_DATA	Das angegebene Attribut ist größer oder gleich NTMS_MAXATTR_LENGTH.
ERROR_NOT_CONNECTED	Es kann keine Verbindung mit dem RSM-Dienst hergestellt werden.
ERROR_OBJECT_NOT_FOUND	Die GUID ist ungültig.
ERROR_SUCCESS	Die Funktion war erfolgreich.

Bemerkungen

Die SetNtmsObjectAttribute--Funktion muss auf dem angegebenen 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.

Um ein Attribut zu löschen, führen Sie einen Satz des Attributs mit einer Länge von Null aus.

Es folgt die Liste der Objekte, die spezielle Zugriffsrechte erfordern.

Objekt	Zugang
NTMS_CHANGER	Erfordert NTMS_MODIFY_ACCESS für die Bibliothek.
NTMS_CHANGER_TYPE	Erfordert NTMS_MODIFY_ACCESS auf dem Computer.
NTMS_COMPUTER	Erfordert NTMS_MODIFY_ACCESS auf dem Computer.
NTMS_DRIVE	Erfordert NTMS_MODIFY_ACCESS für die Bibliothek.
NTMS_DRIVE_TYPE	Erfordert NTMS_MODIFY_ACCESS auf dem Computer.
NTMS_IEDOOR	Erfordert NTMS_MODIFY_ACCESS für die Bibliothek.
NTMS_IEPORT	Erfordert NTMS_MODIFY_ACCESS für die Bibliothek.
NTMS_LIBRARY	Erfordert NTMS_MODIFY_ACCESS für die Bibliothek.
NTMS_LIBREQUEST	Erfordert NTMS_MODIFY_ACCESS für die Bibliothek.
NTMS_LOGICAL_MEDIA	Erfordert NTMS_MODIFY_ACCESS für den Medienpool der logischen Medien.
NTMS_MEDIA_POOL	Erfordert NTMS_MODIFY_ACCESS für den Medienpool.
NTMS_MEDIA_TYPE	Erfordert NTMS_MODIFY_ACCESS auf dem Computer.
NTMS_OPREQUEST	Erfordert NTMS_MODIFY_ACCESS auf dem Computer.
NTMS_PARTITION	Erfordert NTMS_MODIFY_ACCESS für den Medienpool der Seite.
NTMS_PHYSICAL_MEDIA	Erfordert NTMS_MODIFY_ACCESS für den Medienpool.
NTMS_STORAGESLOT	Erfordert NTMS_MODIFY_ACCESS für die Bibliothek.

Anmerkung

Der ntmsapi.h-Header definiert SetNtmsObjectAttribute 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

Siehe auch

EnumerateNtmsObject

GetNtmsObjectAttribute-

Objektverwaltungsfunktionen

Freigeben über