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

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

See also

IADs