ClfsReadNextLogRecord 함수(wdm.h)

ClfsReadNextLogRecord 루틴은 읽기 컨텍스트의 현재 레코드를 기준으로 시퀀스에서 다음 레코드를 읽습니다.

통사론

CLFSUSER_API NTSTATUS ClfsReadNextLogRecord(
  [in, out]      PVOID             pvReadContext,
  [out]          PVOID             *ppvBuffer,
  [out]          PULONG            pcbBuffer,
  [in, out]      PCLFS_RECORD_TYPE peRecordType,
  [in, optional] PCLFS_LSN         plsnUser,
  [out]          PCLFS_LSN         plsnUndoNext,
  [out]          PCLFS_LSN         plsnPrevious,
  [out]          PCLFS_LSN         plsnRecord
);

매개 변수

[in, out] pvReadContext

ClfsReadLogRecord 호출하거나 ClfsReadRestartArea 호출자가 이전에 가져온 읽기 컨텍스트에 대한 포인터입니다.

[out] ppvBuffer

레코드 데이터가 포함된 버퍼에 대한 포인터를 받는 변수에 대한 포인터입니다.

[out] pcbBuffer

*ppvBuffer가리키는 버퍼의 크기(바이트)를 수신하는 ULONG 형식 변수에 대한 포인터입니다. 레코드 읽기의 데이터 버퍼 길이입니다.

[in, out] peRecordType

CLFS_RECORD_TYPE 형식의 변수에 대한 포인터입니다. 호출자는 이 매개 변수를 다음 값 중 하나로 설정해야 합니다.

값	읽을 레코드
ClfsDataRecord	다음 데이터 레코드입니다.
ClfsRestartRecord	다음 다시 시작 레코드입니다.
ClfsClientRecord	데이터 레코드 또는 다시 시작 레코드인 다음 레코드입니다.

[in, optional] plsnUser

읽을 레코드의 LSN을 제공하는 CLFS_LSN 구조체에 대한 포인터입니다. 지정된 레코드는 읽기 컨텍스트(pvReadContext)의 모드(ClfsContextUndoNext, ClfsContextPrevious또는 ClfsContextForward)에 따라 읽은 레코드 대신 읽습니다. plsnUser 제공된 LSN은 읽기 컨텍스트의 현재 LSN보다 작아야 합니다. 이 매개 변수는 NULL 수 있습니다.

[out] plsnUndoNext

읽은 레코드의 실행 취소 다음 LSN을 수신하는 CLFS_LSN 구조체에 대한 포인터입니다.

[out] plsnPrevious

읽은 레코드의 이전 LSN을 수신하는 CLFS_LSN 구조체에 대한 포인터입니다.

[out] plsnRecord

읽은 레코드의 LSN을 수신하는 CLFS_LSN 구조체에 대한 포인터입니다.

반환 값

ClfsReadNextLogRecord 성공하면 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

참고 항목

CLFS_LSN

ClfsReadLogRecord

ClfsReadRestartArea