7.6.1.4 Performing an LDAP Bind on an ADConnection

msdn link

This task authenticates the client to an Active Directory server specified by the elements of an input ADConnection instance.

The parameters for this task are as follows:

Name

Type

Description

Optional

TaskInputADConnection

ADCONNECTION_HANDLE

An ADCONNECTION_HANDLE ([MS-DTYP] section 2.2.2) that refers to an initialized ADConnection on which to perform an LDAP bind.

No

The task returns the following results to the caller:

Name

Type

Description

TaskReturnStatus

Unsigned integer

The LDAP resultCode ([RFC2251] section 4.1.10, Result Message) returned from the directory server in response to the bind request or an error indicating that the directory server could not be contacted.

The task performs the following actions:

  1. Let adConnection be the ADConnection instance in ADCList referred to by TaskInputADConnection.

  2. Invoke the Performing an LDAP Bind Against a Directory Server (section 7.6.2.3) task with the following parameters: TaskInputConnectionInfo is set to adConnection.primaryConnection. This task returns the resulting TaskReturnStatus.