7.6.1.3 Establishing an ADConnection
This task establishes a TCP connection 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 for which a TCP connection to the directory server will be established. |
No |
The task returns the following results to the caller:
|
Name |
Type |
Description |
|---|---|---|
|
TaskReturnStatus |
Boolean |
Returns TRUE if a TCP connection was successfully established and FALSE otherwise. |
The task performs the following actions:
Let adConnection be the ADConnection instance in ADCList referred to by TaskInputADConnection.
Invoke the Connecting to a Directory Server (section 7.6.2.2) task, passing adConnection.primaryConnection as the TaskInputConnectionInfo parameter. The return value of the invocation is returned to the caller as TaskReturnStatus.