IADsPropertyValue2 interface
Applies to: desktop apps only
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.
Beginning with Windows XP, 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.
Members
The IADsPropertyValue2 interface inherits from the IDispatch interface. IADsPropertyValue2 also has these types of members:
Methods
The IADsPropertyValue2 interface has these methods.
| Method | Description |
|---|---|
| GetObjectProperty |
Retrieves the value of an attribute. |
| PutObjectProperty |
Sets the value of an attribute. |
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
|
Minimum supported client | Windows 2000 Professional |
|---|---|
|
Minimum supported server | Windows 2000 Server |
|
Header |
|
|
DLL |
|
|
IID |
IID_IADsPropertyValue2 is defined as 306E831C-5BC7-11D1-A3B8-00C04FB950DC |
See also
Send comments about this topic to Microsoft
Build date: 2/3/2012
