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 |
另请参阅
IDirectoryObject::CreateDSObject
IDirectoryObject::GetObjectAttributes