ldap_get_next_page_s 함수(winldap.h)
ldap_get_next_page_s 함수는 동기 페이징 검색 결과 시퀀스로 다음 페이지를 반환합니다.
구문
WINLDAPAPI ULONG LDAPAPI ldap_get_next_page_s(
[in] PLDAP ExternalHandle,
[in] PLDAPSearch SearchHandle,
[in] l_timeval *timeout,
[in] ULONG PageSize,
[out] ULONG *TotalCount,
[out] LDAPMessage **Results
);
매개 변수
[in] ExternalHandle
세션 핸들입니다.
[in] SearchHandle
검색 블록 핸들입니다.
[in] timeout
클라이언트가 호출이 반환될 때까지 대기하는 시간 값(초)입니다.
[in] PageSize
단일 페이지에서 반환할 항목 수입니다.
[out] TotalCount
전체 결과 집합의 총 항목 수에 대한 서버 추정값입니다. 값이 0이면 서버에서 예상값을 제공할 수 없음을 나타냅니다.
[out] Results
결과를 포함하는 LDAPMessage 구조체에 대한 포인터입니다.
반환 값
서버가 null 쿠키를 반환하는 경우(연속이 아닌) 값은 LDAP_NO_RESULTS_RETURNED. 그렇지 않으면 클라이언트는 LDAP_SUCCESS 반환하여 연속(사용 가능한 더 많은 데이터)을 알릴 수 있습니다.
함수가 실패하면 오류와 관련된 오류 코드 반환 값을 반환합니다. 자세한 내용은 반환 값을 참조하세요.
설명
ldap_get_next_page_s 함수는 검색 결과의 단순하고 동기적인 페이징을 위한 인터페이스의 일부입니다. 초기 호출에서 반환된 검색 핸들을 사용하여 ldap_search_init_page 페이지에서 반환할 항목 수를 PageSize 매개 변수에 지정합니다. PageSize를 0으로 설정하여 검색을 종료합니다.
ldap_get_next_page_s 반환된 결과는 다른 검색 결과로 처리할 수 있으며, 완료되면 ldap_msgfree 호출하여 해제해야 합니다.
결과 집합을 구문 분석할 때 서버에서 결과의 빈 페이지를 반환하면서도 LDAP_SUCCESS 반환 코드로 응답할 수 있습니다. 이는 서버가 시간 제한 또는 기타 이유로 인해 결과 페이지를 검색할 수 없었지만 검색 요청을 완료하지 못했음을 나타냅니다. 이 instance 적절한 동작은 결과의 다른 페이지가 성공적으로 검색되거나, 오류 코드가 반환되거나, 검색이 완료되었음을 나타내기 위해 LDAP_NO_RESULTS_RETURNED반환될 때까지 ldap_get_next_page_s 계속 호출하는 것입니다.
페이징된 검색 결과를 비동기적으로 검색하려면 ldap_get_next_page 사용합니다.
ldap_get_next_page_s 사용하는 경우 서버에서 반환된 페이징된 결과 수를 기록하기 위해 ldap_get_paged_count 호출할 필요는 없습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | winldap.h |
| 라이브러리 | Wldap32.lib |
| DLL | Wldap32.dll |