ITDirectory::Bind-Methode (rend.h)

[Rendezvous IP-Telefonkonferenzsteuerelemente und -schnittstellen sind in Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems nicht verfügbar. Die RTC-Client-API bietet ähnliche Funktionen.]

Die Bind-Methode bindet an den Server.

Syntax

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

Parameter

[in] pDomainName

Zeiger auf einen BSTR , der den Domänennamen des Benutzers enthält.

[in] pUserName

Zeiger auf einen BSTR , der den Namen des Benutzers enthält.

[in] pPassword

Zeiger auf einen BSTR , der das Kennwort des Benutzers enthält.

[in] lFlags

RENDBIND-Flags gibt an, ob alle Parameter überprüft werden müssen oder einen Standardwert annehmen können.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Methode war erfolgreich.
E_POINTER
Der Parameter pDomainName, pUserName oder pPassword ist kein gültiger Zeiger.
E_INVALIDARG
Es ist ein Kennwort erforderlich, es wurde jedoch nicht angegeben, die Domäne und der Benutzer werden nicht angegeben, oder die Domäne wurde angegeben, der Benutzer jedoch nicht.
RND_NOT_CONNECTED
Die METHODE ITDirectory::Connect wurde nicht aufgerufen oder war nicht erfolgreich.

Hinweise

Die Eingabevariablen pDomainName, pUserName und pPassword können NULL sein.

Das Aufrufen dieser Funktion ist optional. Bei einigen Verzeichnisvorgängen muss der Benutzer jedoch zuerst authentifiziert werden. Es ist immer sicher, Bind aufzurufen.

Die Anwendung muss SysAllocString verwenden, um Arbeitsspeicher für die Parameter pDomainName, pUserName und pPassword zuzuweisen. Die Anwendung muss SysFreeString verwenden, um den Arbeitsspeicher freizugeben, wenn die Variablen nicht mehr benötigt werden.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile rend.h
DLL Rend.dll

Weitere Informationen

ITDirectory