IADsOpenDSObject

In order to supply a security context in which to open an object from the underlying directory service, the IADsOpenDSObject interface provides a means to specify a client's credentials. Once these credentials are established, they apply to any actions on this object or on any objects contained within this object. When this object is released, the security context is also released.

When to Implement

Implement IADsOpenDSObject only when you are providing an Active Directory implementation for your directory service. Every provider implements this interface on the ADSI Namespace object.

When to Use

Call the IADsOpenDSObject method when you are binding to an Active Directory object and need to pass a set of credentials to the directory service for permission to bind to and create this object.

Methods in VTable Order

IUnknown Methods	Description
QueryInterface	Returns pointers to supported interfaces.
AddRef	Increments reference count.
Release	Decrements reference count.

IDispatch Methods	Description
GetTypeInfoCount	Gets the number of type descriptions.
GetTypeInfo	Gets a description of object's programmable interface.
GetIDsOfNames	Maps name of method or property to DISPID.
Invoke	Calls one of the object's methods, or gets/sets one of its properties.

IADsOpenDSObject Methods	Description
OpenDSObject	Gets the IDispatch interface on the specified object.