IADsPropertyValue2 接口 (iads.h)
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 |