ADS_ATTR_INFO-Struktur (iads.h)

Artikel
08/24/2023

Die ADS_ATTR_INFO-Struktur wird verwendet, um einen oder mehrere Attributwerte für die Verwendung mit der Methode IDirectoryObject::CreateDSObject, IDirectoryObject::GetObjectAttributes oder IDirectoryObject::SetObjectAttributes zu enthalten.

Syntax

typedef struct _ads_attr_info {
  LPWSTR    pszAttrName;
  DWORD     dwControlCode;
  ADSTYPE   dwADsType;
  PADSVALUE pADsValues;
  DWORD     dwNumValues;
} ADS_ATTR_INFO, *PADS_ATTR_INFO;

Member

pszAttrName

Die mit NULL endende Unicode-Zeichenfolge, die den Attributnamen enthält.

dwControlCode

Enthält einen der ADSI-Attributänderungstypen , der den Typ des Vorgangs bestimmt, der für den Attributwert ausgeführt werden soll.

dwADsType

Ein Wert aus der ADSTYPEENUM-Enumeration , der den Datentyp des Attributs angibt.

pADsValues

Zeiger auf ein Array von ADSVALUE-Strukturen , die Werte für das Attribut enthalten.

dwNumValues

Größe des pADsValues-Arrays .

Hinweise

In ADSI werden Attribute und Eigenschaften austauschbar verwendet. Legen Sie Attribute fest, wenn Sie ein Verzeichnisdienstobjekt mit der IDirectoryObject::CreateDSObject-Methode erstellen. Die IDirectoryObject-Schnittstelle unterstützt auch die Methoden IDirectoryObject::GetObjectAttributes und IDirectoryObject::SetObjectAttributes zum Abrufen und Ändern der Attribute des Objekts in einem Verzeichnis.

Der Arbeitsspeicher für das Array von ADSVALUE-Strukturen ist dieser Struktur nicht zugeordnet.

Der Wert des dwControlCode-Elements wird ignoriert, wenn die Struktur als OUT-Parameter verwendet wird.