Edit

ITDirectory::Bind method (rend.h)

  • Article

[Rendezvous IP Telephony Conferencing controls and interfaces are not available for use in Windows Vista, Windows Server 2008, and subsequent versions of the operating system. The RTC Client API provides similar functionality.]

The Bind method binds to the server.

Syntax

HRESULT Bind(
  [in] BSTR pDomainName,
  [in] BSTR pUserName,
  [in] BSTR pPassword,
  [in] long lFlags
);

Parameters

[in] pDomainName

Pointer to a BSTR containing the user's domain name.

[in] pUserName

Pointer to a BSTR containing the user's name.

[in] pPassword

Pointer to a BSTR containing the user's password.

[in] lFlags

RENDBIND flags indicator of whether all parameters must be validated or can take a default.

Return value

This method can return one of these values.

Return code Description
S_OK
 Method succeeded.
E_POINTER
 The pDomainName, pUserName, or pPassword parameter is not a valid pointer.
E_INVALIDARG
 A password is required but was not supplied, the domain and user are not supplied, or the domain was supplied but the user was not.
RND_NOT_CONNECTED
 The ITDirectory::Connect method has not been invoked or did not succeed.

Remarks

The input variables pDomainName, pUserName, and pPassword can be NULL.

Calling this function is optional. However, some directory operations require the user to be authenticated first. It is always safe to call Bind.

The application must use SysAllocString to allocate memory for the pDomainName, pUserName, and pPassword parameters. The application must use SysFreeString to free the memory when the variables are no longer needed.

Requirements

Requirement Value
Target Platform Windows
Header rend.h
DLL Rend.dll

See also

ITDirectory