Estrutura ADSVALUE (iads.h)

Artigo
08/24/2023

A estrutura ADSVALUE contém um valor especificado como um tipo de dados ADSI. Esses tipos de dados podem ser tipos de dados simples ADSI ou tipos de dados personalizados definidos por ADSI que incluem estruturas de estilo C.

A estrutura ADS_ATTR_INFO contém uma matriz de estruturas ADSVALUE . Cada estrutura ADSVALUE contém um único valor de atributo.

Sintaxe

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;

Membros

dwType

Tipo de dados usado para interpretar o membro da união da estrutura. Os valores desse membro são obtidos da enumeração ADSTYPEENUM .

DNString

A cadeia de caracteres Unicode terminada em nulo que identifica o nome diferenciado (caminho) de um objeto de serviço de diretório, conforme definido por ADS_DN_STRING, um tipo de dados simples ADSI.

CaseExactString

A cadeia de caracteres Unicode terminada em nulo a ser interpretada com diferenciação de maiúsculas e minúsculas, conforme definido por ADS_CASE_EXACT_STRING, um tipo de dados simples ADSI.

CaseIgnoreString

A cadeia de caracteres Unicode terminada em nulo a ser interpretada sem considerar o caso, conforme definido por ADS_CASE_IGNORE_STRING, um tipo de dados simples ADSI.

PrintableString

A cadeia de caracteres Unicode terminada em nulo que pode ser exibida ou impressa, conforme definido por ADS_PRINTABLE_STRING, um tipo de dados simples ADSI.

NumericString

A cadeia de caracteres Unicode terminada em nulo que contém numerais a serem interpretados como texto, conforme definido por ADS_NUMERIC_STRING, um tipo de dados simples ADSI.

Boolean

Valor booliano, conforme definido por ADS_BOOLEAN, um tipo de dados adsi simples.

Integer

Valor inteiro, conforme definido por ADS_INTEGER, um tipo de dados simples ADSI.

OctetString

Uma cadeia de caracteres de octeto, conforme definido por ADS_OCTET_STRING, um tipo de dados definido por ADSI.

UTCTime

Tempo especificado como UTC (Tempo Universal Coordenado), conforme definido por ADS_UTC_TIME, um tipo de dados simples ADSI.

LargeInteger

Valor inteiro longo, conforme definido por ADS_LARGE_INTEGER, um tipo de dados simples ADSI.

ClassName

Cadeia de caracteres de nome de classe, conforme definido por ADS_OBJECT_CLASS, um tipo de dados simples ADSI.

ProviderSpecific

Estrutura específica do provedor, conforme definido por ADS_PROV_SPECIFIC, um tipo de dados definido por ADSI.

pCaseIgnoreList

Ponteiro para um ADS_CASEIGNORE_LIST, um tipo de dados definido por ADSI.

pOctetList

Ponteiro para uma lista de ADS_OCTET_LIST, um tipo de dados definido por ADSI.

pPath

Ponteiro para o nome ADS_PATH , um tipo de dados definido por ADSI.

pPostalAddress

Ponteiro para os dados ADS_POSTALADDRESS , um tipo de dados definido por ADSI.

Timestamp

Carimbo de data/hora do tipo ADS_TIMESTAMP , um tipo de dados definido por ADSI.

BackLink

Um link do tipo ADS_BACKLINK , um tipo de dados definido por ADSI.

pTypedName

Ponteiro para o nome ADS_TYPEDNAME , um tipo de dados definido por ADSI.

Hold

Uma estrutura de dados do tipo ADS_HOLD , um tipo de dados definido por ADSI.

pNetAddress

Ponteiro para os dados ADS_NETADDRESS , um tipo de dados definido por ADSI.

pReplicaPointer

Ponteiro para um ponteiro réplica de ADS_REPLICAPOINTER, um tipo de dados definido por ADSI.

pFaxNumber

Ponteiro para um número fac-símile de ADS_FAXNUMBER, um tipo de dados definido por ADSI.

Email

Email endereço de um usuário de ADS_EMAIL, um tipo de dados definido por ADSI.

SecurityDescriptor

Descritor de segurança do Windows, conforme definido por ADS_NT_SECURITY_DESCRIPTOR, um tipo de dados definido por ADSI.

pDNWithBinary

Ponteiro para uma estrutura ADS_DN_WITH_BINARY que mapeia um nome diferenciado de um objeto para seu valor GUID.

pDNWithString

Ponteiro para uma estrutura ADS_DN_WITH_STRING que mapeia um nome diferenciado de um objeto para um valor de cadeia de caracteres não variável.

Comentários

Os membros da estrutura ADSVALUE especificam o tipo de dados de atributos. Para obter mais informações e um exemplo de código, consulte ADS_ATTR_INFO.