ReadLogArchiveMetadata 함수(clfsw32.h)
메타데이터의 보관 보기 범위를 지정된 버퍼에 복사합니다.
구문
CLFSUSER_API BOOL ReadLogArchiveMetadata(
[in] CLFS_LOG_ARCHIVE_CONTEXT pvArchiveContext,
[in] ULONG cbOffset,
[in] ULONG cbBytesToRead,
[in, out] PBYTE pbReadBuffer,
[out] PULONG pcbBytesRead
);
매개 변수
[in] pvArchiveContext
PrepareLogArchive를 호출하여 가져온 보관 컨텍스트에 대한 포인터입니다.
컨텍스트는 커서 상태를 유지 관리하므로 보관 파일의 파일 익스텐트 집합을 반복할 수 있습니다. 보관 클라이언트는 TerminateLogArchive 함수를 사용하여 컨텍스트의 할당을 취소해야 합니다.
[in] cbOffset
데이터 복사가 시작되는 메타데이터의 오프셋입니다.
이 함수에 대한 첫 번째 호출에서 0을 지정합니다. 후속 호출에서 pcbBytesRead에 반환되는 값을 지정합니다.
[in] cbBytesToRead
pbReadBuffer에 복사해야 스냅샷 메타데이터의 바이트 수입니다.
이 매개 변수는 0일 수 없습니다.
[in, out] pbReadBuffer
메타데이터 스냅샷 복사되는 버퍼에 대한 포인터입니다.
[out] pcbBytesRead
pbReadBuffer에 복사되는 바이트 수를 수신하는 변수에 대한 포인터입니다.
바이트 수는 항상 0과 cbBytesToRead 사이입니다.
반환 값
함수가 성공하면 반환 값이 0이 아닙니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다. 다음 목록에서는 가능한 오류 코드를 식별합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | clfsw32.h |
| 라이브러리 | Clfsw32.lib |
| DLL | Clfsw32.dll |