cldap_open関数 (winldap.h)
cldap_open関数は、コネクションレス ユーザー データグラム プロトコル (UDP) サービス経由で LDAP サーバーとのセッションを確立します。 これは、TCP/IP を使用する代わりの方法です。
構文
WINLDAPAPI LDAP *LDAPAPI cldap_open(
[in] PSTR HostName,
[in] ULONG PortNumber
);
パラメーター
[in] HostName
ホスト名のリストまたは LDAP サーバー ホストの IP アドレスを表す点線の文字列を含む null で終わる文字列へのポインター。 1 つのスペースを使用して、リスト内のホスト名を区切ります。 リスト内の各ホスト名の後にポート番号を指定できます。 オプションのポート番号は、ホスト自体からコロン (:)で区切られます。 LDAP ランタイムは、リストされている順序でホストとの接続を試行し、接続が成功すると停止します。
[in] PortNumber
使用するポート番号。 ポート番号が指定されていない場合、既定値はポート 389 で、LDAP_PORTとして定義されます。 HostName パラメーターにポート番号が含まれている場合、このパラメーターは無視されます。
戻り値
関数が成功すると、LDAP 構造体へのポインターの形式でセッション ハンドルが返されます。 不要になったら、 ldap_unbind の呼び出しでセッション ハンドルを解放します。
関数が失敗した場合は、返される値は NULL です。 エラー コードを取得するには、 LdapGetLastError または Win32 関数 GetLastError を呼び出します。
注釈
cldap_open関数は、ldap_openとは異なり、UDP ベースのコネクションレス LDAP サービスの接続ブロックを作成します。 TCP セッションは維持されません。 ldap_openと同様に、cldap_openはセッションの状態データを維持するために LDAP 構造を割り当て、呼び出し元に戻る前に接続を試行します。 この呼び出しはセッション ハンドルを返します。このハンドルは、セッションの過程で後続の LDAP 関数呼び出しに渡します。 セッションが完了したら、割り当てられたセッション ハンドルを常に ldap_unbindを使用して解放します。
UDP 経由で LDAP を使用してもバインディングはサポートされず、TLS (SSL) または SASL はサポートされません。
マルチスレッド: cldap_open の呼び出しはスレッド セーフです。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | winldap.h |
| Library | Wldap32.lib |
| [DLL] | Wldap32.dll |