IADsPropertyValue2 interface

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.

Methods

The IADsPropertyValue2 interface has these methods.

Method Description
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

   
Windows version Windows Vista Windows Server 2008
Target Platform Windows
Header iads.h

See Also

IADsPropertyEntry

IADsPropertyList

IADsPropertyValue

IDispatch