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
);

[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.

The IDsDisplaySpecifier object uses simple authentication instead of secure authentication.

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

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

Returns a standard HRESULT value including the following.

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.