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.


The IDirectoryObject interface inherits from the IUnknown interface. IDirectoryObject also has these types of members:


The IDirectoryObject interface has these methods.


Creates a child of the current directory service object.

Deletes a leaf object in a directory tree.

Retrieves one or more specified attributes of the directory service object.

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.

The IDirectoryObject::SetObjectAttributes method modifies data in one or more specified object attributes defined in the ADS_ATTR_INFO structure.


Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header iads.h

See also