IDsDisplaySpecifier::SetServer method (dsclient.h)

The IDsDisplaySpecifier::SetServer method specifies the server from which display specifier data is obtained.

Syntax

HRESULT SetServer(
  [in] LPCWSTR pszServer,
  [in] LPCWSTR pszUserName,
  [in] LPCWSTR pszPassword,
  [in] DWORD   dwFlags
);

Parameters

[in] pszServer

Pointer to a null-terminated Unicode string that contains the name of the server that will be used to obtain the display specifier data.

[in] pszUserName

Pointer to a null-terminated Unicode string that contains the user name to be used for access to the server specified in pszServer.

[in] pszPassword

Pointer to a null-terminated Unicode string that contains the password used to access the server specified in pszServer.

[in] dwFlags

Contains a set of flags used to bind to the directory service. This can be zero or a combination of one or more of the following values.

DSSSF_SIMPLEAUTHENTICATE (1 (0x1))

The IDsDisplaySpecifier object uses simple authentication instead of secure authentication.

DSSSF_DONTSIGNSEAL (2 (0x2))

The IDsDisplaySpecifier object does not use signing and sealing when opening objects.

DSSSF_DSAVAILABLE (2147483648 (0x80000000))

The IDsDisplaySpecifier object will not check whether the directory server is available.

Return value

Returns a standard HRESULT value including the following.

Remarks

The server data is cached by the IDsDisplaySpecifier object. The IDsDisplaySpecifier object does not actually bind to the server until a specific method, such as IDsDisplaySpecifier::GetDisplaySpecifier, is called.

Requirements

See also

Display Interfaces in Active Directory Domain Services

IDsDisplaySpecifier

IDsDisplaySpecifier::GetDisplaySpecifier