Edit

Fast Binding Option for Batch Write/Modify Operations

  • Article

When a directory service object is bound to, ADSI creates a COM object that represents the specified directory object. When binding, ADSI will typically retrieve the objectClass attribute so that ADSI can expose the COM interfaces that are appropriate for that class of object. For example, a user object would expose the IADsUser interface in addition to the base ADSI interfaces supported for all objects. For a single operation, this should have no effect on performance. However, if batch operations are performed that require hundreds or thousands of bindings over a slow connection and those operations are writing data to the directory service, it may be desirable to exchange full object support for faster binding. This is known as a fast-bind and is accomplished by specifying the ADS_FAST_BIND flag when ADsOpenObject or IADsOpenDSObject::OpenDSObject is called.

Fast-binding has the following restrictions:

  • The bind operation must be performed with the ADsOpenObject function or IADsOpenDSObject::OpenDSObject method. The bind operation goes to the directory server once instead of twice. ADSI does not retrieve the objectClass attribute and, therefore, exposes only the base ADSI interfaces for the object.

  • The following interfaces are supported for the COM object:

  • If the IADsContainer::GetObject method is used to bind to child objects, the child object has the same fast-bind characteristics as the parent.

  • The existence of the object being bound to is not verified during the bind operation, so subsequent method calls will fail if the object does not exist. Because of this, fast-binding should only be used for objects that are known to exist, for example, directly after performing a query that returned the distinguished names of the objects being bound to.

  • ADSI extensions are exposed for objects of class top. Therefore, only the extensions for the base ADSI interfaces listed above are exposed.