cldap_open函式 (winldap.h)

cldap_open函式會透過無連線的用戶數據報通訊協定 (UDP) 服務，建立與 LDAP 伺服器的會話。 這是使用 TCP/IP 的替代方式。

語法

WINLDAPAPI LDAP *LDAPAPI cldap_open(
  [in] PSTR  HostName,
  [in] ULONG PortNumber
);

參數

[in] HostName

Null 終止字串的指標，其中包含代表 LDAP 伺服器主機 IP 位址的主機名或虛線字串清單。 使用單一空格分隔清單中的主機名。 清單中的每個主機名可能後面接著埠號碼。 選擇性埠號碼會與主機本身分隔，並以冒號 (：) 。 LDAP 運行時間會依照列出的順序嘗試與主機連線，並在成功連線時停止。

[in] PortNumber

要使用的埠號碼。 如果未指定埠號碼，則預設值為埠 389，定義為LDAP_PORT。 如果 HostName 參數中包含埠號碼，則會忽略此參數。

傳回值

如果函式成功，則會以LDAP結構的指標形式傳回會話句柄。 不再需要會話句柄，並呼叫 ldap_unbind 。

如果函式失敗，則傳回值為 NULL。 若要取得錯誤碼，請呼叫 LdapGetLastError 或 Win32 函式 GetLastError。

備註

與 ldap_open 不同的cldap_open函式會建立 UDP 型無連線 LDAP 服務的連線區塊。 不會維護 TCP 工作階段。 如同ldap_open，cldap_open會配置 LDAP結構來維護會話的狀態數據，然後在返回呼叫端之前嘗試進行連線。 呼叫會傳回會話句柄，您會在會話過程中傳遞至後續的LDAP函式呼叫。 當會話完成時，請一律使用 ldap_unbind釋放配置的會話句柄。

使用LDAP over UDP不支援系結，而且不支援TLS (SSL) 或 SASL。

多線程： 對cldap_open 的呼叫是安全線程的。

注意 使用 cldap_open時，匿名用戶會開啟連線。 唯一可用的作業是匿名使用者可以執行的作業。

 

規格需求

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

請參閱

函式

GetLastError

LdapGetLastError

ldap_open

ldap_unbind