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.

Members

The IADsPropertyValue2 interface inherits from the IDispatch interface. IADsPropertyValue2 also has these types of members:

Methods

The IADsPropertyValue2 interface has these methods.

MethodDescription
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 valuepvProp 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 Vista

Minimum supported server

Windows Server 2008

Header

Iads.h

DLL

Activeds.dll

IID

IID_IADsPropertyValue2 is defined as 306E831C-5BC7-11D1-A3B8-00C04FB950DC

See also

IDispatch
IADsPropertyEntry
IADsPropertyList
IADsPropertyValue

 

 

Show: