7.6.1.2 Setting an LDAP Option on an ADConnection

This task sets one of the LDAP_OPT_<optionName> ADM elements on an ADConnection.

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 set an option.

No

TaskInputOptionName

String(Unicode)

The name of the LDAP_OPT ADM element to set.

No

TaskInputOptionValue

MUST match the type of the ADM element specified by TaskInputOptionName.

The value to assign to the specified ADM element.

No

This task does not return any results.

The task performs the following actions:

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

  2. Set the ADM element from adConnection with name TaskInputOptionName to the value TaskInputOptionValue.