iads.h) (ADSVALUE 结构

ADSVALUE 结构包含指定为 ADSI 数据类型的值。 这些数据类型可以是 ADSI 简单数据类型 ,也可以是包含 C 样式结构的 ADSI 定义的自定义数据类型。

ADS_ATTR_INFO 结构包含 ADSVALUE 结构的数组。 每个 ADSVALUE 结构都包含单个属性值。

语法

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;

成员

dwType

用于解释结构的联合成员的数据类型。 此成员的值取自 ADSTYPEENUM 枚举。

DNString

以 null 结尾的 Unicode 字符串,标识目录服务对象的可分辨名称 (路径) ,如 ADS_DN_STRING 定义, ADSI 简单数据类型

CaseExactString

要区分大小写解释的以 null 结尾的 Unicode 字符串,由 ADS_CASE_EXACT_STRING 定义,这是 一种 ADSI 简单数据类型

CaseIgnoreString

要解释的以 null 结尾的 Unicode 字符串,而不考虑 由 ADS_CASE_IGNORE_STRING 定义的大小写, ADSI 简单数据类型

PrintableString

可以显示或打印的以 null 结尾的 Unicode 字符串,如 ADS_PRINTABLE_STRING定义的那样,是 ADSI 简单数据类型

NumericString

以 null 结尾的 Unicode 字符串,其中包含要解释为文本的数字,如 ADS_NUMERIC_STRING 定义, ADSI 简单数据类型

Boolean

ADS_BOOLEAN 定义的布尔值, ADSI 简单数据类型

Integer

ADS_INTEGER 定义的整数值, ADSI 简单数据类型

OctetString

ADS_OCTET_STRING 定义的八进制字符串,ADSI 定义的数据类型。

UTCTime

指定为协调世界时 (UTC) 的时间,由 ADS_UTC_TIME 定义的 ADSI 简单数据类型

LargeInteger

ADS_LARGE_INTEGER 定义的长整数值, ADSI 简单数据类型

ClassName

类名字符串,由 ADS_OBJECT_CLASS 定义的 ADSI 简单数据类型

ProviderSpecific

提供程序特定的结构(由 ADS_PROV_SPECIFIC 定义)是 ADSI 定义的数据类型。

pCaseIgnoreList

指向 ADS_CASEIGNORE_LIST(ADSI 定义的数据类型)的指针。

pOctetList

指向 ADS_OCTET_LIST列表的指针,该列表是 ADSI 定义的数据类型。

pPath

指向 ADS_PATH 名称(ADSI 定义的数据类型)的指针。

pPostalAddress

指向 ADS_POSTALADDRESS 数据的指针,这是 ADSI 定义的数据类型。

Timestamp

ADS_TIMESTAMP类型的时间戳,ADSI 定义的数据类型。

BackLink

ADS_BACKLINK类型的链接,ADSI 定义的数据类型。

pTypedName

指向 ADS_TYPEDNAME 名称(ADSI 定义的数据类型)的指针。

Hold

ADS_HOLD类型的数据结构,ADSI 定义的数据类型。

pNetAddress

指向 ADS_NETADDRESS 数据的指针,ADSI 定义的数据类型。

pReplicaPointer

指向ADS_REPLICAPOINTER(ADSI 定义的数据类型)的副本 (replica) 指针的指针。

pFaxNumber

指向ADS_FAXNUMBER(ADSI 定义的数据类型)的传真号的指针。

Email

Email ADS_EMAIL 用户的地址,ADSI 定义的数据类型。

SecurityDescriptor

Windows 安全描述符,由 ADS_NT_SECURITY_DESCRIPTOR 定义,是 ADSI 定义的数据类型。

pDNWithBinary

指向 ADS_DN_WITH_BINARY 结构的指针,该结构将对象的可分辨名称映射到其 GUID 值。

pDNWithString

指向 ADS_DN_WITH_STRING 结构的指针,该结构将对象的可分辨名称映射到非可变字符串值。

注解

ADSVALUE 结构的成员指定属性的数据类型。 有关详细信息和代码示例,请参阅 ADS_ATTR_INFO

要求

   
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
标头 iads.h

另请参阅

ADSI 简单数据类型

ADSI 结构

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