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