IDirectoryObject interface (iads.h)
The IDirectoryObject interface is a non-Automation COM interface that provides clients with direct access to directory service objects. The interface enables access by means of a direct over-the-wire protocol, rather than through the ADSI attribute cache. Using the over-the-wire protocol optimizes performance. With IDirectoryObject, a client can get, or set, any number of object attributes with one method call. Unlike the corresponding Automation methods, which are invoked in batch, those of IDirectoryObject are executed when they are called. IDirectoryObject performs no attribute caching.
Non-Automation clients can call the methods of IDirectoryObject to optimize performance and take advantage of native directory service interfaces. Automation clients cannot use IDirectoryObject. Instead, they should use the IADs interface.
Of the ADSI system-supplied providers, only the LDAP provider supports this interface.
Inheritance
The IDirectoryObject interface inherits from the IUnknown interface. IDirectoryObject also has these types of members:
Methods
The IDirectoryObject interface has these methods.
| IDirectoryObject::CreateDSObject Creates a child of the current directory service object. |
| IDirectoryObject::DeleteDSObject Deletes a leaf object in a directory tree. |
| IDirectoryObject::GetObjectAttributes Retrieves one or more specified attributes of the directory service object. |
| IDirectoryObject::GetObjectInformation The IDirectoryObject::GetObjectInformation method retrieves a pointer to an ADS_OBJECT_INFO structure that contains data regarding the identity and location of a directory service object. |
| IDirectoryObject::SetObjectAttributes The IDirectoryObject::SetObjectAttributes method modifies data in one or more specified object attributes defined in the ADS_ATTR_INFO structure. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Target Platform | Windows |
| Header | iads.h |