Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.