Structure ADSVALUE (iads.h)

Article
08/24/2023

La structure ADSVALUE contient une valeur spécifiée en tant que type de données ADSI. Ces types de données peuvent être des types de données SIMPLES ADSI ou des types de données personnalisés définis par ADSI qui incluent des structures de style C.

La structure ADS_ATTR_INFO contient un tableau de structures ADSVALUE . Chaque structure ADSVALUE contient une seule valeur d’attribut.

Syntaxe

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;

Membres

dwType

Type de données utilisé pour interpréter le membre d’union de la structure. Les valeurs de ce membre sont extraites de l’énumération ADSTYPEENUM .

DNString

Chaîne Unicode terminée par null qui identifie le nom unique (chemin) d’un objet de service d’annuaire, tel que défini par ADS_DN_STRING, un type de données SIMPLE ADSI.

CaseExactString

Chaîne Unicode terminée par null à interpréter en respectant la casse, telle que définie par ADS_CASE_EXACT_STRING, un type de données SIMPLE ADSI.

CaseIgnoreString

Chaîne Unicode terminée par null à interpréter sans tenir compte de la casse, telle que définie par ADS_CASE_IGNORE_STRING, un type de données SIMPLE ADSI.

PrintableString

Chaîne Unicode terminée par null qui peut être affichée ou imprimée, comme défini par ADS_PRINTABLE_STRING, un type de données SIMPLE ADSI.

NumericString

Chaîne Unicode terminée par null qui contient des chiffres à interpréter comme du texte, tels que définis par ADS_NUMERIC_STRING, un type de données SIMPLE ADSI.

Boolean

Valeur booléenne, telle que définie par ADS_BOOLEAN, un type de données simple ADSI.

Integer

Valeur entière, telle que définie par ADS_INTEGER, un type de données simple ADSI.

OctetString

Chaîne d’octets, telle que définie par ADS_OCTET_STRING, type de données défini par ADSI.

UTCTime

Heure spécifiée en temps universel coordonné (UTC), telle que définie par ADS_UTC_TIME, un type de données SIMPLE ADSI.

LargeInteger

Valeur entière longue, telle que définie par ADS_LARGE_INTEGER, type de données simple ADSI.

ClassName

Chaîne de nom de classe, telle que définie par ADS_OBJECT_CLASS, un type de données simple ADSI.

ProviderSpecific

Structure spécifique au fournisseur, telle que définie par ADS_PROV_SPECIFIC, un type de données défini par ADSI.

pCaseIgnoreList

Pointeur vers un ADS_CASEIGNORE_LIST, un type de données défini par ADSI.

pOctetList

Pointeur vers une liste de ADS_OCTET_LIST, un type de données défini par ADSI.

pPath

Pointeur vers le nom ADS_PATH , un type de données défini par ADSI.

pPostalAddress

Pointeur vers les données ADS_POSTALADDRESS , un type de données défini par ADSI.

Timestamp

Horodatage du type ADS_TIMESTAMP , type de données défini par ADSI.

BackLink

Lien du type ADS_BACKLINK , un type de données défini par ADSI.

pTypedName

Pointeur vers le nom ADS_TYPEDNAME , un type de données défini par ADSI.

Hold

Structure de données du type ADS_HOLD , type de données défini par ADSI.

pNetAddress

Pointeur vers le ADS_NETADDRESS données, un type de données défini par ADSI.

pReplicaPointer

Pointeur vers un pointeur réplica de ADS_REPLICAPOINTER, un type de données défini par ADSI.

pFaxNumber

Pointeur vers un numéro de fac-similé de ADS_FAXNUMBER, un type de données défini par ADSI.

Email

Email’adresse d’un utilisateur de ADS_EMAIL, un type de données défini par ADSI.

SecurityDescriptor

Descripteur de sécurité Windows, tel que défini par ADS_NT_SECURITY_DESCRIPTOR, un type de données défini par ADSI.

pDNWithBinary

Pointeur vers une structure ADS_DN_WITH_BINARY qui mappe un nom unique d’un objet à sa valeur GUID.

pDNWithString

Pointeur vers une structure ADS_DN_WITH_STRING qui mappe un nom unique d’un objet à une valeur de chaîne nonvarying.

Notes

Les membres de la structure ADSVALUE spécifient le type de données des attributs. Pour plus d’informations et un exemple de code, consultez ADS_ATTR_INFO.