ADSVALUE

The ADSVALUE structure contains a value specified as an ADSI data type. These data types can be ADSI Simple Data Types or ADSI-defined custom data types that include C-structs.

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

Data type used to interpret the union member of the structure. Values of this member are taken from the ADSTYPEENUM enumeration.

DNString

The null-terminated Unicode string that identifies the distinguished name (path) of a directory service object, as defined by ADS_DN_STRING, an ADSI simple data type.

CaseExactString

The null-terminated Unicode string to be interpreted case-sensitively, as defined by ADS_CASE_EXACT_STRING, an ADSI simple data type.

CaseIgnoreString

The null-terminated Unicode string to be interpreted without regard to case, as defined by ADS_CASE_IGNORE_STRING, an ADSI simple data type.

PrintableString

The null-terminated Unicode string that can be displayed or printed, as defined by ADS_PRINTABLE_STRING, an ADSI simple data type.

NumericString

The null-terminated Unicode string that contains numerals to be interpreted as text, as defined by ADS_NUMERIC_STRING, an ADSI simple data type.

Boolean

Boolean value, as defined by ADS_BOOLEAN, an ADSI simple data type.

Integer

Integer value, as defined by ADS_INTEGER, an ADSI simple data type.

OctetString

An octet string, as defined by ADS_OCTET_STRING, an ADSI-defined data type.

UTCTime

Time specified as Coordinated Universal Time (UTC), as defined by ADS_UTC_TIME, an ADSI simple data type.

LargeInteger

Long integer value, as defined by ADS_LARGE_INTEGER, an ADSI simple data type.

ClassName

Class name string, as defined by ADS_OBJECT_CLASS, an ADSI simple data type.

ProviderSpecific

Provider-specific structure, as defined by ADS_PROV_SPECIFIC, an ADSI-defined data type.

pCaseIgnoreList

Pointer to a ADS_CASEIGNORE_LIST, an ADSI-defined data type used for the NDS provider.

pOctetList

Pointer to a list of ADS_OCTET_LIST, an ADSI-defined data type used for the NDS provider.

pPath

Pointer to the ADS_PATH name, an ADSI-defined data type used for the NDS provider.

pPostalAddress

Pointer to the ADS_POSTALADDRESS data, an ADSI-defined data type used for the NDS provider.

Timestamp

Time stamp of the ADS_TIMESTAMP type, an ADSI-defined data type used for the NDS provider.

BackLink

A link of the ADS_BACKLINK type, an ADSI-defined data type used for the NDS provider.

pTypedName

Pointer to the ADS_TYPEDNAME name, an ADSI-defined data type used for the NDS provider.

Hold

A data structure of the ADS_HOLD type, an ADSI-defined data type used for the NDS provider.

pNetAddress

Pointer to the ADS_NETADDRESS data, an ADSI-defined data type used for the NDS provider.

pReplicaPointer

Pointer to a replica pointer of ADS_REPLICAPOINTER, an ADSI-defined data type used for the NDS provider.

pFaxNumber

Pointer to a facsimile number of ADS_FAXNUMBER, an ADSI-defined data type used for the NDS provider.

Email

E-mail address of a user of ADS_EMAIL, an ADSI-defined data type used for the NDS provider.

SecurityDescriptor

Windows NT/Windows 2000 security descriptor, as defined by ADS_NT_SECURITY_DESCRIPTOR, an ADSI-defined data type.

pDNWithBinary

Pointer to an ADS_DN_WITH_BINARY structure that maps a distinguished name of an object to its GUID value.

pDNWithString

Pointer to an ADS_DN_WITH_STRING structure that maps a distinguished name of an object to a non-varying string value.

Remarks

Members of the ADSVALUE structure specify the data type of attributes. For more information and an example, see ADS_ATTR_INFO.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Header: Declared in Iads.h.

See Also

ADSI Simple Data Types, ADSI Structures, 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, ADSTYPEENUM, IDirectorySearch::SetSearchPreference