ldap_first_entry関数 (winldap.h)

ldap_first_entry関数は、メッセージの最初のエントリを返します。

構文

WINLDAPAPI LDAPMessage *LDAPAPI ldap_first_entry(
  [in] LDAP        *ld,
  [in] LDAPMessage *res
);

[in] ld

セッションハンドル。

[in] res

同期検索ルーチンまたは ldap_resultのいずれかの呼び出しによって取得された検索結果。

検索で有効な結果が返された場合、この関数は最初の結果エントリへのポインターを返します。結果セットにエントリまたは参照が存在しない場合は、 NULL を返します。これは唯一のエラーリターンです。いずれの場合も、LDAP データ構造のセッションエラーパラメーターは 0 にクリアされます。

ldap_first_entryをldap_next_entryと組み合わせて使用して、検索結果チェーンからエントリの一覧をステップ実行して取得します。

メッセージ自体が解放されたときに解放されるため、返されたエントリを明示的に解放する必要はありません。