The IADsOpenDSObject interface is designed to supply a security context for binding to an object in the underlying directory store. It provides a means for specifying credentials of a client. Use this interface to bind to an ADSI object when you must supply a set of credentials for authentication in any directory service.
ADSI maintains the security context in its cache. Thus, throughout the connection within a process, Once authenticated, the supplied user credentials are applied to any actions performed on this object and its children. This credential caching model applies to binding to different objects as well, provided that the binding takes place within the same connection and process.
Calling the OpenDSObject method of this interface yields the cache handle. Releasing this cache handle releases the security context as well.
The IADsOpenDSObject interface inherits the methods of the standard COM interfaces:
In addition, IADsOpenDSObject defines the following method.
|OpenDSObject||Gets the IDispatch interface on the specified object.|
Client: Included in Windows XP and
Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Header: Declared in Iads.h.
IADsClass, IADsOpenDSObject::OpenDSObject, IDispatch