IADsContainer

The IADsContainer interface enables an ADSI container object to create, delete and manage other Active Directory objects. Container objects are used both to organize the Active Directory hierarchical architecture and to directly represent the hierarchical nature of directory trees in a file system.

Properties accessed by IADsContainer are defined on the ADSI Container Object.

Note  Every ADSI container object supports both IADs and IADsContainer. IADs::GetInfo does not affect the objects stored in the container but affects only the properties of the container. IADs::SetInfo called on a container affects any newly created objects within the container and the container's properties.

When to Implement

Implement IADsContainer only when you are providing an Active Directory implementation for your directory service. Every Active Directory object that contains other Active Directory objects must support this interface.

When to Use

Call these methods to enumerate or manage the life-cycle of Active Directory objects contained by this object. For example, you can recursively navigate down a hierarchical directory tree. By calling QueryInterface for the IADsContainer method, you can tell if there are further levels on the tree. If the interface is not supported, you are at a leaf. If the interface is supported, you are at another container, and can call QueryInterface on that object.

In addition to representing a directory tree, ADSI containers are used to implement the Active Directory architecture. Examples of ADSI container objects include the ADSI Namespaces Object (contains ADSI Namespace Objects), the ADSI Namespace Object (contains all the roots of an Active Directory provider implementation), and other provider-specific containers.

Methods in VTable Order