ADSVALUE-Struktur (iads.h)

Die ADSVALUE-Struktur enthält einen Wert, der als ADSI-Datentyp angegeben ist. Diese Datentypen können einfache ADSI-Datentypen oder ADSI-definierte benutzerdefinierte Datentypen sein, die Strukturen im C-Stil enthalten.

Die ADS_ATTR_INFO-Struktur enthält ein Array von ADSVALUE-Strukturen . Jede ADSVALUE-Struktur enthält einen einzelnen Attributwert.

Syntax

typedef struct _adsvalue {
  ADSTYPE dwType;
  union {
    ADS_DN_STRING              DNString;
    ADS_CASE_EXACT_STRING      CaseExactString;
    ADS_CASE_IGNORE_STRING     CaseIgnoreString;
    ADS_PRINTABLE_STRING       PrintableString;
    ADS_NUMERIC_STRING         NumericString;
    ADS_BOOLEAN                Boolean;
    ADS_INTEGER                Integer;
    ADS_OCTET_STRING           OctetString;
    ADS_UTC_TIME               UTCTime;
    ADS_LARGE_INTEGER          LargeInteger;
    ADS_OBJECT_CLASS           ClassName;
    ADS_PROV_SPECIFIC          ProviderSpecific;
    PADS_CASEIGNORE_LIST       pCaseIgnoreList;
    PADS_OCTET_LIST            pOctetList;
    PADS_PATH                  pPath;
    PADS_POSTALADDRESS         pPostalAddress;
    ADS_TIMESTAMP              Timestamp;
    ADS_BACKLINK               BackLink;
    PADS_TYPEDNAME             pTypedName;
    ADS_HOLD                   Hold;
    PADS_NETADDRESS            pNetAddress;
    PADS_REPLICAPOINTER        pReplicaPointer;
    PADS_FAXNUMBER             pFaxNumber;
    ADS_EMAIL                  Email;
    ADS_NT_SECURITY_DESCRIPTOR SecurityDescriptor;
    PADS_DN_WITH_BINARY        pDNWithBinary;
    PADS_DN_WITH_STRING        pDNWithString;
  };
} ADSVALUE, *PADSVALUE, *LPADSVALUE;

Members

dwType

Datentyp, der verwendet wird, um den Union-Member der -Struktur zu interpretieren. Die Werte dieses Members stammen aus der ADSTYPEENUM-Enumeration .

DNString

Die mit Null endende Unicode-Zeichenfolge, die den distinguished Name (Path) eines Verzeichnisdienstobjekts identifiziert, wie durch ADS_DN_STRING definiert, einem einfachen ADSI-Datentyp.

CaseExactString

Die unicode-Zeichenfolge mit Null-Endung, die groß-/klein interpretiert werden soll, wie von ADS_CASE_EXACT_STRING definiert, einem einfachen ADSI-Datentyp.

CaseIgnoreString

Die mit Null endende Unicode-Zeichenfolge, die ohne Berücksichtigung der Groß-/Kleinschreibung interpretiert werden soll, wie von ADS_CASE_IGNORE_STRING definiert, einem einfachen ADSI-Datentyp.

PrintableString

Die unicode-Zeichenfolge mit Null-Termin, die angezeigt oder gedruckt werden kann, wie von ADS_PRINTABLE_STRING definiert, einem einfachen ADSI-Datentyp.

NumericString

Die mit Null endende Unicode-Zeichenfolge, die Zahlen enthält, die als Text interpretiert werden sollen, wie von ADS_NUMERIC_STRING definiert, einem einfachen ADSI-Datentyp.

Boolean

Boolescher Wert, wie durch ADS_BOOLEAN definiert, ein einfacher ADSI-Datentyp.

Integer

Ganzzahliger Wert, wie von ADS_INTEGER definiert, einem einfachen ADSI-Datentyp.

OctetString

Eine Oktettzeichenfolge, wie von ADS_OCTET_STRING definiert, einem ADSI-definierten Datentyp.

UTCTime

Zeit, die als koordinierte Weltzeit (UTC) angegeben wird, wie von ADS_UTC_TIME, einem einfachen ADSI-Datentyp, definiert.

LargeInteger

Long-Integer-Wert, wie durch ADS_LARGE_INTEGER definiert, ein einfacher ADSI-Datentyp.

ClassName

Klassennamenzeichenfolge, wie von ADS_OBJECT_CLASS definiert, einem einfachen ADSI-Datentyp.

ProviderSpecific

Anbieterspezifische Struktur, wie von ADS_PROV_SPECIFIC definiert, einem ADSI-definierten Datentyp.

pCaseIgnoreList

Zeiger auf einen ADS_CASEIGNORE_LIST, einen ADSI-definierten Datentyp.

pOctetList

Zeiger auf eine Liste von ADS_OCTET_LIST, einem adsI-definierten Datentyp.

pPath

Zeiger auf den ADS_PATH Namen, einen adsI-definierten Datentyp.

pPostalAddress

Zeiger auf den ADS_POSTALADDRESS Daten, einen adsI-definierten Datentyp.

Timestamp

Zeitstempel des ADS_TIMESTAMP Typs, ein ADSI-definierter Datentyp.

BackLink

Ein Link des ADS_BACKLINK-Typs , ein adsi-definierter Datentyp.

pTypedName

Zeiger auf den ADS_TYPEDNAME Namen, ein ADSI-definierter Datentyp.

Hold

Eine Datenstruktur des ADS_HOLD Typs, ein ADSI-definierter Datentyp.

pNetAddress

Zeiger auf die ADS_NETADDRESS Daten, einen ADSI-definierten Datentyp.

pReplicaPointer

Zeiger auf einen Replikatzeiger von ADS_REPLICAPOINTER, einem durch ADSI definierten Datentyp.

pFaxNumber

Zeiger auf eine faksimile Anzahl von ADS_FAXNUMBER, einem ADSI-definierten Datentyp.

Email

Email Adresse eines Benutzers von ADS_EMAIL, einem durch ADSI definierten Datentyp.

SecurityDescriptor

Windows-Sicherheitsdeskriptor, wie von ADS_NT_SECURITY_DESCRIPTOR definiert, einem adsI-definierten Datentyp.

pDNWithBinary

Zeiger auf eine ADS_DN_WITH_BINARY Struktur, die dem GUID-Wert einen distinguished Name eines Objekts zuordnet.

pDNWithString

Zeiger auf eine ADS_DN_WITH_STRING-Struktur , die einen distinguished Name eines Objekts einem nicht variablen Zeichenfolgenwert zuordnet.

Hinweise

Member der ADSVALUE-Struktur geben den Datentyp der Attribute an. Weitere Informationen und ein Codebeispiel finden Sie unter ADS_ATTR_INFO.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Kopfzeile iads.h

Weitere Informationen

EINFACHE ADSI-Datentypen

ADSI-Strukturen

ADSTYPEENUM

ADS_ATTR_INFO

ADS_BACKLINK

ADS_CASEIGNORE_LIST

ADS_DN_WITH_BINARY

ADS_DN_WITH_STRING

ADS_EMAIL

ADS_FAXNUMBER

ADS_HOLD

ADS_NETADDRESS

ADS_NT_SECURITY_DESCRIPTOR

ADS_OCTET_LIST

ADS_OCTET_STRING

ADS_PATH

ADS_POSTALADDRESS

ADS_PROV_SPECIFIC

ADS_REPLICAPOINTER

ADS_TIMESTAMP

ADS_TYPEDNAME

IDirectoryObject::CreateDSObject

IDirectoryObject::GetObjectAttributes

IDirectoryObject::SetObjectAttributes

IDirectorySearch::SetSearchPreference