ldap_connect 函式 (winldap.h)

ldap_connect函式會建立與伺服器的連線。

語法

WINLDAPAPI ULONG LDAPAPI ldap_connect(
  [in] LDAP      *ld,
  [in] l_timeval *timeout
);

參數

[in] ld

從 ldap_init取得的會話控制碼。

[in] timeout

LDAP_TIMEVAL結構的指標，指定在逾時之前嘗試建立連線所花費的秒數。 如果為 Null，則函式會使用預設逾時值。

傳回值

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

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

備註

雖然用戶端呼叫 ldap_connect 建立與伺服器的連線並非必要，但最好是程式設計做法。 如果連線不存在，其他函式例如 ，ldap_bind_s，請在內部執行呼叫。 不過，如果您必須針對應用程式的這個部分進行疑難排解，在呼叫其他函式之前建立連線，例如 ldap_bind_s，如果連線失敗，也會分隔可能的問題。 或者，您也可以在連線區塊上指定其他選項。 例如，用戶端可以呼叫ldap_init來初始化會話，然後使用非Null逾時參數值呼叫ldap_connect，以使用指定的逾時連線到伺服器。

如果 對 ldap_connect 的 呼叫成功，用戶端會以匿名使用者身分連線到 LDAP 伺服器。 當不再需要會話控制碼時，應該釋放對 ldap_unbind 的呼叫。

如果 ldap_connect 呼叫失敗，當不再需要錯誤復原時，應該釋放會話控制碼，並呼叫 ldap_unbind 。

規格需求

另請參閱

建立 LDAP 會話

函式

LDAP_TIMEVAL

傳回值

ldap_init

ldap_unbind