ADS_OPTION_ENUM

The ADS_OPTION_ENUM enumeration type contains values that indicate the options that can be retrieved or set with the IADsObjectOptions::GetOption and IADsObjectOptions::SetOption methods.

typedef enum 
{
  ADS_OPTION_SERVERNAME = 0, 
  ADS_OPTION_REFERRALS = 1, 
  ADS_OPTION_PAGE_SIZE = 2, 
  ADS_OPTION_SECURITY_MASK = 3, 
  ADS_OPTION_MUTUAL_AUTH_STATUS = 4, 
  ADS_OPTION_QUOTA = 5, 
  ADS_OPTION_PASSWORD_PORTNUMBER = 6, 
  ADS_OPTION_PASSWORD_METHOD = 7
} ADS_OPTION_ENUM;

Values

ADS_OPTION_SERVERNAME

Retrieves a VT_BSTR that contains the host name of the server for the current binding to this object. This option is only supported by the IADsObjectOptions::GetOption method.

ADS_OPTION_REFERRALS

Retrieves or sets a VT_I4 value that indicates how referral chasing is performed in a query. This option can contain one of the values defined by the ADS_CHASE_REFERRALS_ENUM enumeration.

ADS_OPTION_PAGE_SIZE

Retrieves or sets a VT_I4 value that indicates the page size in a paged search.

ADS_OPTION_SECURITY_MASK

Retrieves or sets a VT_I4 value that controls the security descriptor data that can be read on the object. This option can contain any combination of the values defined in the ADS_SECURITY_INFO_ENUM enumeration.

ADS_OPTION_MUTUAL_AUTH_STATUS

Retrieves a VT_I4 value that determines if mutual authentication is performed by the SSPI layer. This value should be masked with the ISC_RET_MUTUAL_AUTH flag, as defined in Sspi.h. If the result is non-zero, then mutual authentication has been performed. If the result is zero, then mutual authentication has not been performed. For more information about mutual authentication, see SSPI. This option is only supported by the IADsObjectOptions::GetOption method.

ADS_OPTION_QUOTA

Allows the effective quota and used quota of a security principal to be read. This option takes a VT_BSTR value that contains the security principal that the quotas can be read for. If the security principal string is zero length or the value is a VT_EMPTY value, the security principal is the currently logged on user. This option is only supported by the IADsObjectOptions::SetOption method.

Windows XP, Windows 2000, Windows NT and Windows Me/98/95:  Not supported.

ADS_OPTION_PASSWORD_PORTNUMBER

Retrieves or sets a VT_I4 value that contains the port number that ADSI uses to establish a connection when the password is set or changed. By default, ADSI uses port 636 to establish a connection to set or change the password.

Windows XP, Windows 2000, Windows NT and Windows Me/98/95:  Not supported.

ADS_OPTION_PASSWORD_METHOD

Retrieves or sets a VT_I4 value that specifies the password encoding method. This option can contain one of the values defined in the ADS_PASSWORD_ENCODING_ENUM enumeration.

Windows XP, Windows 2000, Windows NT and Windows Me/98/95:  Not supported.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Header: Declared in Iads.h.

See Also

IADsObjectOptions, IADsObjectOptions::GetOption, IADsObjectOptions::SetOption, ADS_SECURITY_INFO_ENUM, ADS_PASSWORD_ENCODING_ENUM, ADSI Enumerations