7.6.1.4 Performing an LDAP Bind on an ADConnection
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 |
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:
Let adConnection be the ADConnection instance in ADCList referred to by TaskInputADConnection.
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.