Platform SDK: Active Directory, ADSI, and 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 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.

Methods in Vtable Order

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.

Requirements

  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.

See Also

IADs::GetInfo, IADs::GetInfoEx, IADs::SetInfo, IADsPropertyEntry Property Methods, IADsPropertyList, IADsPropertyList_GetPropertyItem, IADsPropertyList_Item, IDispatch, property cache