IADsPropertyValue2 接口用于表示任何数据格式(包括新数据类型或客户定义的数据类型)的 IADsPropertyEntry 对象的值。 此接口还可用于处理多个目录服务的属性值。
IADsPropertyEntry.Values 属性包含 IADsPropertyValue2 对象的数组。 每个 IADsPropertyValue 对象都包含 IADsPropertyEntry 对象的单个值。 有关详细信息以及创建全新的属性条目和值的代码示例,请参阅 IADsPropertyList.PutPropertyItem。
在调用此接口的方法之前,必须显式调用 IADs.GetInfo 或 IADs.GetInfoEx ,以将对象的分配值加载到缓存中(如果缓存尚未初始化)。 修改对象的值后,必须调用 IADs.SetInfo 以将更改保存到基础目录的永久性存储中。
此接口比 IADsPropertyValue 更通用,因为此接口可用于获取任何数据类型。 IADsPropertyValue 接口只能用于获取有限数量的数据类型。
继承
IADsPropertyValue2 接口继承自 IDispatch 接口。 IADsPropertyValue2 还具有以下类型的成员:
方法
IADsPropertyValue2 接口具有这些方法。
|
IADsPropertyValue2::GetObjectProperty 检索属性值。 |
|
IADsPropertyValue2::P utObjectProperty 设置属性值。 |
注解
下表列出了 GetObjectProperty 和 PutObjectProperty 方法中对应的 pvProp 数据类型的 lnADsType 参数值。
| lnADsType 值 | pvProp 数据类型 |
|---|---|
| ADSTYPE_INVALID | 不可用。 |
| ADSTYPE_DN_STRING | VT_BSTR |
| ADSTYPE_CASE_EXACT_STRING | VT_BSTR |
| ADSTYPE_CASE_IGNORE_STRING | VT_BSTR |
| ADSTYPE_PRINTABLE_STRING | VT_BSTR |
| ADSTYPE_NUMERIC_STRING | VT_BSTR |
| ADSTYPE_BOOLEAN | VT_BOOL |
| ADSTYPE_INTEGER | VT_I4 |
| ADSTYPE_OCTET_STRING | | VT_ARRAYVT_UI4 |
| ADSTYPE_UTC_TIME | VT_DATE |
| ADSTYPE_LARGE_INTEGER | VT_DISPATCH (IADsLargeInteger) |
| ADSTYPE_PROV_SPECIFIC | | VT_ARRAYVT_UI1 |
| ADSTYPE_OBJECT_CLASS | 不可用。 |
| ADSTYPE_CASEIGNORE_LIST | VT_DISPATCH (IADsCaseIgnoreList) |
| ADSTYPE_OCTET_LIST | VT_DISPATCH (IADsOctetList) |
| ADSTYPE_PATH | VT_DISPATCH (IADsPath) |
| ADSTYPE_POSTALADDRESS | VT_DISPATCH (IADsPostalAddress) |
| ADSTYPE_TIMESTAMP | VT_DISPATCH (IADsTimestamp) |
| ADSTYPE_BACKLINK | VT_DISPATCH (IADsBackLink) |
| ADSTYPE_TYPEDNAME | VT_DISPATCH (IADsTypedName) |
| ADSTYPE_HOLD | VT_DISPATCH (IADsHold) |
| ADSTYPE_NETADDRESS | VT_DISPATCH (IADsNetAddress) |
| ADSTYPE_REPLICAPOINTER | VT_DISPATCH (IADsReplicaPointer) |
| ADSTYPE_FAXNUMBER | VT_DISPATCH (IADsFaxNumber) |
| ADSTYPE_EMAIL | VT_DISPATCH (IADsEmail) |
| ADSTYPE_NT_SECURITY_DESCRIPTOR | VT_DISPATCH (IADsSecurityDescriptor) |
| ADSTYPE_UNKNOWN | 不可用。 |
| ADSTYPE_DN_WITH_BINARY | VT_DISPATCH (IADsDNWithBinary) |
| ADSTYPE_DN_WITH_STRING | VT_DISPATCH (IADsDNWithString) |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 最低受支持的服务器 | Windows Server 2008 |
| 目标平台 | Windows |
| 标头 | iads.h |