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