ldap_simple_bind函式 (winldap.h)

發行項
03/13/2024

ldap_simple_bind函式會使用純文字密碼向伺服器驗證用戶端。

謹慎此函式會傳送名稱和密碼，而不加密它們，因此網路上有人竊聽可能會讀取密碼。除非已建立 TLS (SSL) 加密工作階段，否則請勿使用此函式。如需如何設定加密會話的詳細資訊，請參閱初始化會話。

語法

WINLDAPAPI ULONG LDAPAPI ldap_simple_bind(
  [in] LDAP       *ld,
  [in] const PSTR dn,
  [in] const PSTR passwd
);

參數

[in] ld

會話句柄。

[in] dn

要系結為的用戶名稱。系結作業會使用 dn 和 passwd 參數來驗證使用者。

[in] passwd

dn 參數中指定的用戶密碼。

傳回值

如果函式成功，它會傳回起始之作業的訊息標識碼。

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

備註

ldap_simple_bind函式會起始簡單的異步系結作業，以向LDAP伺服器驗證用戶端。後續的系結呼叫可用來使用相同的連線重新驗證。

若要以特定使用者身分進行驗證，請提供專案名稱 (使用者) 和該專案的密碼。若要驗證匿名使用者，若不需要任何訪問許可權，請將 NULL 傳遞至 dn 和 passwd 參數。

作為異步函式， ldap_simple_bind 傳回作業的訊息標識符。使用訊息標識符呼叫ldap_result ，以取得作業的結果。若要在完成之前取消異步系結作業，請呼叫 ldap_abandon。請注意，如果連絡LDAP 2 伺服器，在系結呼叫成功完成之前，請勿嘗試透過連線進行其他作業。

若要直接傳回結果，請使用同步例程 ldap_simple_bind_s。

多線程：系結呼叫並不安全，因為它們會套用至整個連線。如果線程共用連線，並嘗試與其他作業進行線程系結，請小心。

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

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

ldap_simple_bind函式的設計目的是要系結至本機網域。函式無法用於跨樹系驗證。

規格需求

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