| Platform SDK: Active Directory, ADSI, and Directory Services |
The IADsPropertyValue interface is used to represent in a property value of a property entry in the cache in one of the pre-defined data types. This interfaces exposes several properties for rendering data values in the corresponding data format. For example, IADsPropertyValue::get_LargeInteger results in a number of LargeInteger type.
A property value is held by a property entry. You can call the IADsPropertyEntry::get_Values property method to obtain the property values of an ADSI object.
When rendering property values in a format not defined in this interface, you should use the IADsPropertyValue2 interface.
Before calling the methods of this interfaces, you must call IADs::GetInfo or IADs::GetInfoEx explicitly to load the assigned property values of the object into the cache, if the cache has not been initialized. After calling the methods of this interface, you must call IADs::SetInfo to save the changes to the persistent store of the underlying directory.
The IADsPropertyValue exposes the following properties and methods.
| IUnknown methods | Description |
|---|---|
| QueryInterface | Returns pointers to supported interfaces. |
| AddRef | Increments reference count. |
| Release | Decrements reference count. |
| IDispatch methods | Description |
|---|---|
| GetTypeInfoCount | Gets the number of type descriptions. |
| GetTypeInfo | Gets a description of object's programmable interface. |
| GetIDsOfNames | Maps name of method or property to DISPID. |
| Invoke | Calls one of the object's methods, or gets and sets one of its properties. |
| IADsPropertyValue property methods | Description |
|---|---|
| Clear | Clears the PropertyValue object's current value. |
| get/put_ADsType | Gets and sets a property value's data type. |
| get/put_DNString | Gets and sets an object's distinguished name (pathname). |
| get/put_CaseExactString | Gets and sets the value of a case-sensitive string. |
| get/put_CaseIgnoreString | Gets and sets the value of a case-insensitive string. |
| get/put_PrintableString | Gets and sets the value of a printable string. |
| get/put_NumericString | Gets and sets the value of a string consisting of numeric characters. |
| get/put_Boolean | Gets and sets a Boolean value. |
| get/put_Integer | Gets and sets an integer value. |
| get/put_OctetString | Gets and sets the value of a string of eight-bit characters. |
| get/put_SecurityDescriptor | Gets and sets a security descriptor. |
| get/put_LargeInteger | Gets and sets a large-integer value. |
| get/put_UTCTime | Gets and sets a Coordinated Universal Time value. |
Windows NT/2000: Requires Windows 2000 (or Windows NT 4.0 with DSClient).
Windows 95/98: Requires Windows 95 or later (with DSClient).
Header: Declared in Iads.h.
IADs::GetInfo, IADs::GetInfoEx, IADs::SetInfo, IADsPropertyEntry, IADsPropertyValue Property Methods, IADsPropertyValue2