Platform SDK: Active Directory, ADSI, and Directory Services |
The IADsPropertyEntry interface is used to manage a property entry in the property cache. A property entry holds a value (or values) of an attribute as defined in the schema. It is identified by the name of the corresponding attribute. A property entry object allows a user to specify how its values are to be manipulated. Examples of such operations include "update", "modify", and "delete".
Multiple property entries are managed by a property list. To access a property entry, you use the Item property or call the GetPropertyItem method on the IADsPropertyList interface.
Use the property methods of IADsPropertyEntry to examine and manipulate individual properties. Before calling the methods of this interface, you must call IADs::GetInfo or IADs::GetInfoEx explicitly to load the assigned property values of the object into the cache. After calling the methods of this interfaces, you must call IADs::SetInfo to save the changes in the persistent store of the underlying directory.
The IADsPropertyEntry interface inherits from the IDispatch interface and exposes several property methods, as summarized in the following table.
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. |
IADsPropertyEntry property methods | Description |
---|---|
get/put_Name | Gets and sets the name of the property entry. |
get/put_ADS_Type | Gets and sets the ADS data type of the property entry. |
get/put_ControlCode | Gets and sets |
get/put_Values | Gets and sets the current values of a property entry. |
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 Property Methods, IADsPropertyList, IADsPropertyList_GetPropertyItem, IADsPropertyList_Item, IDispatch, property cache