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_next_reference 함께 ldap_first_reference 사용하여 검색 결과 체인에서 연속 참조 목록을 단계별로 실행하고 검색합니다.
함수는 검색 응답에서 반환되는 하위 조회(참조)를 반환합니다. 하위 조회는 서버가 일부 데이터를 반환하고 조회가 트리의 현재 수준 아래의 다른 명명 컨텍스트에 전달된 조회입니다. 명명 컨텍스트가 서버에 없는 외부 참조를 단계별로 실행하려면 대신 ldap_parse_result 사용합니다.
메시지 자체가 해제되면 해제되므로 반환된 참조를 명시적으로 해제할 필요가 없습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | winldap.h |
| 라이브러리 | Wldap32.lib |
| DLL | Wldap32.dll |