ldap_simple_bind_s函式 (winldap.h)

ldap_simple_bind_s函式會使用純文字密碼，以同步方式向伺服器驗證用戶端。

謹慎此函式會傳送名稱和密碼，而不加密它們，而且網路上未經授權的使用者可能會讀取密碼。除非已建立 TLS (SSL) 加密會話，否則請勿執行此函式。如需如何設定加密會話的詳細資訊，請參閱初始化會話。

語法

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

[in] ld

會話控制碼。

[in] dn

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

[in] passwd

dn參數中指定的使用者密碼。

如果函式成功，傳回值 會LDAP_SUCCESS。

如果函式失敗，它會傳回錯誤碼。如需詳細資訊，請參閱傳回值。

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

完成系結作業時， ldap_simple_bind_s 會返回呼叫端。如果您想要以非同步方式執行作業，請使用 ldap_simple_bind 。請注意，如果連絡 LDAP 2 伺服器，在系結呼叫成功完成之前，請勿嘗試透過連線進行其他作業。

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

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

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