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 |