ldap_result関数 (winldap.h)
ldap_result関数は、非同期操作の結果を取得します。
構文
WINLDAPAPI ULONG LDAPAPI ldap_result(
[in] LDAP *ld,
[in] ULONG msgid,
[in] ULONG all,
[in] PLDAP_TIMEVAL timeout,
[out] PLDAPMessage *res
);
パラメーター
[in] ld
セッション ハンドル。
[in] msgid
操作のメッセージ ID、または結果が必要な場合は定数LDAP_RES_ANY。
[in] all
ldap_resultの 1 回の呼び出しで取得されるメッセージの数を指定します。 このパラメーターは、検索結果に対してのみ意味があります。 定数 LDAP_MSG_ONE (0x00) を渡して、一度に 1 つのメッセージを取得します。 LDAP_MSG_ALL (0x01) を渡して、すべての結果を 1 つのチェーンで返す前に、検索のすべての結果を受信するように要求します。 LDAP_MSG_RECEIVED (0x02) を渡して、これまでに取得したすべての結果を結果チェーンで返す必要があることを示します。
[in] timeout
結果が返されるのを待機する時間 (秒単位) を指定するタイムアウト。 NULL 値を指定すると、結果が使用可能になるまでldap_resultがブロックされます。 タイムアウト値が 0 秒の場合、ポーリング動作が指定されます。
[out] res
操作の結果を格納します。 返される結果は、アプリケーションで不要になったら 、ldap_msgfree の呼び出しで解放する必要があります。
戻り値
関数が成功した場合、 res パラメーターの最初の結果の型を示すために、次のいずれかの値が返されます。 タイムアウトが切れた場合、関数は 0 を返します。
関数が失敗した場合、-1 が返され、LDAP データ構造のセッション エラー パラメーターが設定されます。
注釈
ldap_result関数は、前の非同期的に開始された操作の結果を取得します。 呼び出し方法によっては、 ldap_result が実際にメッセージのリストまたは "チェーン" を返す場合があることに注意してください。
コネクションレス LDAP の場合は、LDAP 接続ハンドルとメッセージ ID の両方を渡して、正しい結果が得られるようにする必要があります。 LDAP ランタイムは、応答を受信するまで要求を送信し続けます。
マルチスレッド: ldap_result の呼び出しはスレッド セーフです。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | winldap.h |
| Library | Wldap32.lib |
| [DLL] | Wldap32.dll |