| 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. See the example code under IADsPropertyList::PutPropertyItem for a sample when creating entirely new property values and property entries.
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 interface inherits the methods of the standard COM interfaces:
In addition, IADsPropertyValue defines the following methods.
| Method | Description |
|---|---|
| Clear | Clears the PropertyValue object's current value. |
| get_ADsType | Gets and sets a property value's data type. |
| put_ADsType | Gets and sets a property value's data type. |
| get_DNString | Gets and sets an object's distinguished name (path name). |
| put_DNString | Gets and sets an object's distinguished name (path name). |
| get_CaseExactString | Gets and sets the value of a case-sensitive string. |
| put_CaseExactString | Gets and sets the value of a case-sensitive string. |
| get_CaseIgnoreString | Gets and sets the value of a case-insensitive string. |
| put_CaseIgnoreString | Gets and sets the value of a case-insensitive string. |
| get_PrintableString | Gets and sets the value of a printable string. |
| put_PrintableString | Gets and sets the value of a printable string. |
| get_NumericString | Gets and sets the value of a string consisting of numeric characters. |
| put_NumericString | Gets and sets the value of a string consisting of numeric characters. |
| get_Boolean | Gets and sets a Boolean value. |
| put_Boolean | Gets and sets a Boolean value. |
| get_Integer | Gets and sets an integer value. |
| put_Integer | Gets and sets an integer value. |
| get_OctetString | Gets and sets the value of a string of eight-bit characters. |
| put_OctetString | Gets and sets the value of a string of eight-bit characters. |
| get_SecurityDescriptor | Gets and sets a security descriptor. |
| put_SecurityDescriptor | Gets and sets a security descriptor. |
| get_LargeInteger | Gets and sets a large-integer value. |
| put_LargeInteger | Gets and sets a large-integer value. |
| get_UTCTime | Gets and sets a Coordinated Universal Time value. |
| put_UTCTime | Gets and sets a Coordinated Universal Time value. |
The IADsPropertyValue interface defines the following properties. The preceding table includes access methods for these properties.
| Property | Description |
|---|---|
| ADsType | Gets and sets a property value's data type. |
| Boolean | Gets and sets a Boolean value. |
| CaseExactString | Gets and sets the value of a case-sensitive string. |
| CaseIgnoreString | Gets and sets the value of a case-insensitive string. |
| DNString | Gets and sets an object's distinguished name (path name). |
| Integer | Gets and sets an integer value. |
| LargeInteger | Gets and sets a large-integer value. |
| NumericString | Gets and sets the value of a string consisting of numeric characters. |
| OctetString | Gets and sets the value of a string of eight-bit characters. |
| PrintableString | Gets and sets the value of a printable string. |
| SecurityDescriptor | Gets and sets a security descriptor. |
| UTCTime | Gets and sets a Coordinated Universal Time value. |
Client: Included in Windows XP and
Windows 2000 Professional.
Server: Included in Windows Server 2003 and
Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension
on Windows NT 4.0 SP6a and Windows 95/98/Me.
Header: Declared in Iads.h.
IADs::GetInfo, IADs::GetInfoEx, IADs::SetInfo, IADsPropertyEntry, IADsPropertyValue Property Methods, IADsPropertyValue2