IADsPropertyValue2 interface (iads.h)
The IADsPropertyValue2 interface is used to represent the value of an IADsPropertyEntry object in any data format, including new or customer-defined data types. This interface is also useful for handling attribute values for multiple directory services.
The IADsPropertyEntry.Values property contains an array of IADsPropertyValue2 objects. Each of the IADsPropertyValue objects contains a single value of the IADsPropertyEntry object. For more information and a code example for creating entirely new property entries and values, see IADsPropertyList.PutPropertyItem.
Before calling the methods of this interfaces, you must call IADs.GetInfo or IADs.GetInfoEx explicitly to load the assigned values of the object into the cache, if the cache has not been initialized. After modifying the values of the object, you must call IADs.SetInfo to save the changes to the persistent store of the underlying directory.
This interface is more versatile than the IADsPropertyValue because this interface can be used to obtain any data type. The IADsPropertyValue interface can only be used to obtain a limited number of data types.
Inheritance
The IADsPropertyValue2 interface inherits from the IDispatch interface. IADsPropertyValue2 also has these types of members:
Methods
The IADsPropertyValue2 interface has these methods.
| IADsPropertyValue2::GetObjectProperty Retrieves an attribute value. |
| IADsPropertyValue2::PutObjectProperty Sets an attribute value. |
Remarks
The following table lists the lnADsType parameter values in the GetObjectProperty and PutObjectProperty methods to the corresponding pvProp data type.
| lnADsType value | pvProp data type |
|---|---|
| ADSTYPE_INVALID | Not available. |
| 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_ARRAY | VT_UI4 |
| ADSTYPE_UTC_TIME | VT_DATE |
| ADSTYPE_LARGE_INTEGER | VT_DISPATCH (IADsLargeInteger) |
| ADSTYPE_PROV_SPECIFIC | VT_ARRAY | VT_UI1 |
| ADSTYPE_OBJECT_CLASS | Not available. |
| 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 | Not available. |
| ADSTYPE_DN_WITH_BINARY | VT_DISPATCH (IADsDNWithBinary) |
| ADSTYPE_DN_WITH_STRING | VT_DISPATCH (IADsDNWithString) |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Target Platform | Windows |
| Header | iads.h |