ldap_next_reference関数 (winldap.h)
ldap_next_reference関数は、検索結果チェーンから参照を取得します。
構文
WINLDAPAPI LDAPMessage *LDAPAPI ldap_next_reference(
[in] LDAP *ld,
[in] LDAPMessage *entry
);
パラメーター
[in] ld
セッション ハンドル。
[in] entry
ldap_first_referenceまたはldap_next_referenceに対する以前の呼び出しによって返されたエントリ。
戻り値
検索で有効な結果が返された場合、この関数は結果セット内の次の結果エントリへのポインターを返します。 結果セットにそれ以上のエントリまたは参照が存在しない場合は、 NULL を返します。 これは唯一のエラーリターンです。いずれの場合も、LDAP データ構造のセッション エラー パラメーターは 0 にクリアされます。
解説
ldap_next_referenceをldap_first_referenceと組み合わせて使用して、検索結果チェーンから継続参照の一覧をステップ実行して取得します。
関数は、検索応答で返される下位参照 (参照) を返します。 下位参照とは、サーバーがデータを返し、参照がツリーの現在のレベルより下の他の名前付けコンテキストに渡された紹介です。 名前付けコンテキストがサーバーに存在しない外部参照をステップ実行するには、 ldap_parse_resultを使用します。
メッセージ自体が解放されると解放されるため、返された参照を明示的に解放する必要はありません。
要件
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | winldap.h |
| Library | Wldap32.lib |
| [DLL] | Wldap32.dll |