IADsPropertyList interface (iads.h)
The IADsPropertyList interface is used to modify, read, and update a list of property entries in the property cache of an object. It serves to enumerate, modify, and purge the contained property entries. Use the enumeration method of this interface to identify initialized properties. This is different from using the schema to determine all possible attributes that an ADSI object can have and which properties have been set.
Call the methods of the IADsPropertyList interface to examine and manipulate the property list on the client. 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 interface, you must call IADs::SetInfo to save the changes in the persistent store of the underlying directory.
To obtain the property list of an ADSI object, bind to its IADsPropertyList interface. You must call the GetInfo method before calling other methods of property list object, if the property cache has not been initialized.
Inheritance
The IADsPropertyList interface inherits from the IDispatch interface. IADsPropertyList also has these types of members:
Methods
The IADsPropertyList interface has these methods.
| IADsPropertyList::GetPropertyItem Retrieves the item that matches the name from the list. |
| IADsPropertyList::Item The IADsPropertyList::Item method retrieves the specified property item from the list. |
| IADsPropertyList::Next The IADsPropertyList::Next method gets the next item in the property list. The returned item is a Property Entry object. |
| IADsPropertyList::PurgePropertyList Deletes all items from the property list. |
| IADsPropertyList::PutPropertyItem Updates the values for an item in the property list. |
| IADsPropertyList::Reset Resets the list to the first item. |
| IADsPropertyList::ResetPropertyItem Removes the specified item from the list; that is, from the cache. |
| IADsPropertyList::Skip Skips a specified number of items, counting from the current cursor position, in the property list. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Target Platform | Windows |
| Header | iads.h |