ClfsReadRestartArea 루틴은 가장 최근에 지정된 CLFS 스트림에 기록된 다시 시작 레코드를 읽습니다.
통사론
CLFSUSER_API NTSTATUS ClfsReadRestartArea(
[in, out] PVOID pvMarshalContext,
[out] PVOID *ppvRestartBuffer,
[out] PULONG pcbRestartBuffer,
[out] PCLFS_LSN plsn,
[out] PVOID *ppvReadContext
);
매개 변수
[in, out] pvMarshalContext
CLFS 스트림과 연결된 마샬링 영역을 나타내는 불투명 컨텍스트에 대한 포인터입니다. 호출자는 이전에 ClfsCreateMarshallingArea호출하여 이 포인터를 얻었습니다.
[out] ppvRestartBuffer
다시 시작 레코드의 데이터 버퍼에 대한 포인터를 받는 변수에 대한 포인터입니다.
[out] pcbRestartBuffer
pcbRestartBuffer가리키는 데이터 버퍼의 크기(바이트)를 수신하는 ULONG 형식 변수에 대한 포인터입니다. 다시 시작 레코드의 데이터 버퍼 길이입니다.
[out] plsn
읽은 다시 시작 레코드의 LSN을 수신하는 CLFS_LSN 구조체에 대한 포인터입니다.
[out] ppvReadContext
불투명 읽기 컨텍스트에 대한 포인터를 받는 변수에 대한 포인터입니다. 호출자는 이 컨텍스트를 ClfsReadPreviousRestartArea 또는 ClfsReadNextLogRecord 전달할 수 있습니다. 호출자가 읽기 컨텍스트 사용을 마쳤으면 ClfsTerminateReadLog호출하여 컨텍스트를 해제해야 합니다.
반환 값
ClfsReadRestartArea 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 Ntstatus.h에 정의된 오류 코드 중 하나를 반환합니다.
발언
CLFS 개념 및 용어에 대한 설명은 공통 로그 파일 시스템참조하세요.
CLFS 스트림에서 레코드를 읽는 방법에 대한 자세한 내용은 CLFS 스트림 데이터 레코드 읽기 CLFS 스트림 다시 시작 레코드를참조하세요.
읽기 컨텍스트는 스레드로부터 안전하지 않습니다. 클라이언트는 읽기 컨텍스트에 대한 액세스를 직렬화해야 합니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Server 2003 R2, Windows Vista 및 이후 버전의 Windows에서 사용할 수 있습니다. |
| 대상 플랫폼 | 바탕 화면 |
| 헤더 | wdm.h(Wdm.h 포함) |
| 라이브러리 | Clfs.lib |
| DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |