Directory Services

IADsPropertyEntry

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.

Methods in Vtable Order

The IADsPropertyEntry interface inherits the methods of the standard COM interfaces:

In addition, IADsPropertyEntry defines the following methods.

Method Description
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.

Properties

The IADsPropertyEntry interface defines the following properties. The preceding table includes access methods for these properties.

Property Description
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.

Requirements

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.

See Also

IADs::GetInfo, IADs::GetInfoEx, IADs::SetInfo, IADsPropertyEntry Property Methods, IADsPropertyList, IADsPropertyList::GetPropertyItem, IADsPropertyList::Item, IDispatch