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_next_entry 함께 ldap_first_entry 사용하여 검색 결과 체인에서 항목 목록을 단계별로 검색합니다.

메시지 자체가 해제되면 해제되므로 반환된 항목을 명시적으로 해제할 필요가 없습니다.