GetNextLogArchiveExtent 함수(clfsw32.h)
로그 보관 컨텍스트에서 다음 보관 익스텐트 집합을 검색합니다. 로그 보관 컨텍스트는 PrepareLogArchive 캡처에서 캡처한 활성 로그의 스냅샷 걸쳐 있는 연속 파일 익스텐트 집합을 설명합니다. GetNextLogArchiveExtent 는 순서가 지정된 로그 보관 설명자 집합에 커서를 유지 관리하므로 후속 호출을 통해 애플리케이션이 전체 집합을 반복할 수 있습니다.
구문
CLFSUSER_API BOOL GetNextLogArchiveExtent(
[in] CLFS_LOG_ARCHIVE_CONTEXT pvArchiveContext,
[in, out] CLFS_ARCHIVE_DESCRIPTOR [] rgadExtent,
[in] ULONG cDescriptors,
[out] PULONG pcDescriptorsReturned
);
매개 변수
[in] pvArchiveContext
PrepareLogArchive를 호출하여 가져온 보관 컨텍스트에 대한 포인터입니다.
컨텍스트는 커서 상태를 유지 관리하므로 보관 파일의 파일 익스텐트 집합을 반복할 수 있습니다. 보관 클라이언트는 TerminateLogArchive 함수를 사용하여 컨텍스트의 할당을 취소해야 합니다.
[in, out] rgadExtent
이 함수에서 채울 CLFS_ARCHIVE_DESCRIPTOR 구조체의 클라이언트 할당 배열입니다.
[in] cDescriptors
rgadExtent 배열의 요소 수입니다.
이 값은 이 함수에서 검색할 수 있는 최대 보관 설명자 수입니다.
[out] pcDescriptorsReturned
이 함수에 의해 채워진 rgadExtent 배열의 설명자 수입니다.
이 값이 cDescriptors보다 작으면 설명자 집합이 소진되고 보관 클라이언트는 순서가 지정된 설명자 집합을 통해 반복을 종료할 수 있습니다. 이 함수에 대한 추가 호출은 ERROR_NO_MORE_ENTRIES 함께 실패합니다.
반환 값
함수가 성공하면 반환 값이 0이 아닙니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다. 다음 목록에서는 가능한 오류 코드를 식별합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | clfsw32.h |
| 라이브러리 | Clfsw32.lib |
| DLL | Clfsw32.dll |