7.6.1.1 Initializing an ADConnection
This task initializes an instance of the ADConnection element and returns it to the caller.
The parameters for this task are as follows:
|
Name |
Type |
Description |
Optional |
|---|---|---|---|
|
TaskInputTargetName |
String(Unicode) |
A string used to locate a domain controller. It can be NULL (which indicates that the joined domain name SHOULD be used), a domain name (DNS/NetBIOS), a server host name, or a server IP address. |
No |
|
TaskInputPortNumber |
Unsigned integer |
The destination TCP port number ([RFC793] section 1.5, Operation) to use when connecting to the directory server specified by TaskInputTargetName. |
No |
The task returns the following results to the caller:
|
Name |
Type |
Description |
|---|---|---|
|
TaskReturnADConnection |
An ADCONNECTION_HANDLE ([MS-DTYP] section 2.2.2) that refers to an instance of the ADConnection ADM element. |
The task performs the following actions:
Create an instance of the ADConnection ADM structure and initialize the values in the ADM to their default values. This instance is added to the list ADCList.
Invoke the Initializing a Connection to a Directory Server (section 7.6.2.1) task, passing the TaskInputTargetName and TaskInputPortNumber parameters provided by the caller of this task. The returned TaskReturnConnectionInfo is assigned to ADConnection.primaryConnection.
Using TaskReturnADConnection, return an ADCONNECTION_HANDLE ([MS-DTYP] section 2.2.2) that refers to the ADConnection instance to the caller.