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 call Item or 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 the methods of the standard COM interfaces:
In addition, IADsPropertyEntry defines the following methods.
|get_Name||Gets and sets the name of the property entry.|
|put_Name||Gets and sets the name of the property entry.|
|get_ADS_Type||Gets and sets the ADS data type of the property entry.|
|put_ADS_Type||Gets and sets the ADS data type of the property entry.|
|get_ControlCode||Gets and sets the operation to be performed on the named property entry|
|put_ControlCode||Gets and sets the operation to be performed on the named property entry|
|get_Values||Gets and sets the current values of a property entry.|
|put_Values||Gets and sets the current values of a property entry.|
The IADsPropertyEntry interface defines the following properties. The preceding table includes access methods for these properties.
|ADS_Type||Gets and sets the ADS data type of the property entry.|
|ControlCode||Gets and sets the operation to be performed on the named property entry|
|Name||Gets and sets the name of the property entry.|
|Values||Gets and sets the current values of a property entry.|
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 Property Methods, IADsPropertyList, IADsPropertyList::GetPropertyItem, IADsPropertyList::Item, IDispatch