ldap_bind函式 (winldap.h)

發行項
08/27/2023

ldap_bind函式會以非同步方式向 LDAP 伺服器驗證用戶端。系結作業會藉由提供辨別名稱和某種類型的驗證認證，例如密碼，來識別用戶端至目錄伺服器。使用的驗證方法會決定所需的認證類型。

謹慎除非建立 TLS (SSL) 加密會話，否則請勿使用此函式。此函式會以純文字傳送名稱和密碼。未經授權的使用者監視網路流量可能會讀取密碼。如需如何建立加密會話的詳細資訊，請參閱初始化會話。

語法

WINLDAPAPI ULONG LDAPAPI ldap_bind(
  [in] LDAP        *ld,
  [in] const PSTR  dn,
  [in] const PCHAR cred,
  [in] ULONG       method
);

參數

[in] ld

會話控制碼。

[in] dn

Null 終止字串的指標，其中包含用來系結之專案的辨別名稱。

[in] cred

Null 終止字串的指標，其中包含要用於驗證的認證。您可以使用此參數傳遞任意認證。認證的格式和內容取決於方法參數的設定。如需詳細資訊，請參閱＜備註＞一節。

[in] method

要使用的驗證方法。

傳回值

如果函式成功，傳回值就是起始作業的訊息識別碼。

如果函式失敗，它會傳回 –1，並在 LDAP 結構中設定會話錯誤參數。

備註

此 ldap_bind 實作支援下列驗證方法。

驗證方法	描述	認證
LDAP_AUTH_SIMPLE	使用純文字密碼進行驗證。	包含使用者密碼的字串。

LDAP_AUTH_SIMPLE 是唯一與非同步系結版本相容的驗證方法; ldap_bind。搭配 ldap_bind 使用任何其他驗證方法將會失敗，並傳回 LDAP_PARAM_ERROR。使用LDAP_AUTH_SIMPLE方法呼叫ldap_bind相當於呼叫ldap_simple_bind。所有其他驗證方法都需要同步系結，如 ldap_bind_s所提供。

請注意，LDAP 2 伺服器必須先系結應用程式，再嘗試任何其他需要驗證的作業。

多執行緒：系結呼叫並不安全，因為它們會套用至整個連線。如果執行緒共用連線，而且盡可能執行緒系結作業與其他作業，請使用警告。

注意 Microsoft LDAP 用戶端會針對每個系結回應往返使用預設逾時值為 120 秒。您可以使用 LDAP_OPT_TIMELIMIT 會話選項來變更此逾時值。除非使用 ldap_set_option指定，否則其他作業不會有逾時。

當會話控制碼上的所有作業都完成時，請將 LDAP 會話控制碼傳遞至 ldap_unbind 函式，以終止會話。此外，如果 ldap_bind 呼叫失敗，當不再需要錯誤復原時，應該釋放會話控制碼，並呼叫 ldap_unbind 。

規格需求


最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
目標平台	Windows
標頭	winldap.h
程式庫	Wldap32.lib
Dll	Wldap32.dll