ClfsAdvanceLogBase 함수(wdm.h)

  • 아티클

ClfsAdvanceLogBase 루틴은 CLFS 스트림의 기본 LSN을 설정합니다.

구문

CLFSUSER_API NTSTATUS ClfsAdvanceLogBase(
  [in, out] PVOID     pvMarshalContext,
  [in]      PCLFS_LSN plsnBase,
  [in]      ULONG     fFlags
);

매개 변수

[in, out] pvMarshalContext

CLFS 스트림과 연결된 마샬링 영역을 나타내는 불투명 컨텍스트에 대한 포인터입니다. 호출자는 이전에 ClfsCreateMarshallingArea를 호출하여 이 포인터를 얻었습니다.

[in] plsnBase

새 기본 LSN을 포함하는 CLFS_LSN 구조체에 대한 포인터입니다. 이 매개 변수는 스트림에 있는 레코드 중 하나의 LSN이어야 합니다. 또한 이 매개 변수는 스트림의 현재 기본 LSN보다 크거나 같아야 하며 스트림의 현재 마지막 LSN보다 작거나 같아야 합니다.

[in] fFlags

이 매개 변수는 시스템 사용을 위해 예약되어 있습니다. 호출자는 이 매개 변수를 0으로 설정해야 합니다.

반환 값

ClfsAdvanceLogBase 는 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 Ntstatus.h에 정의된 오류 코드 중 하나를 반환합니다.

설명

ClfsAdvanceLogBase 는 CLFS 로그에 레코드를 쓰지 않습니다. 로그에 대한 유일한 업데이트는 메타데이터에 있습니다. 기본 LSN을 업데이트하고 스트림에 다시 시작 레코드를 동시에 쓰려면 ClfsWriteRestartArea를 호출합니다.

가능하면 CLFS는 LSN이 새 기본 LSN보다 작은 큐에 대기 중인 로그 레코드를 안정적인 스토리지에 쓰는 것을 방지합니다.

ClfsAdvanceLogBase는 plsnBase에 제공된 LSN이 실제로 스트림에 있는 레코드 중 하나의 LSN인지 여부를 확인하기 위해 검사 않습니다. 호출자가 plsnBase 를 스트림에 있는 레코드 중 하나의 LSN이 아닌 LSN으로 설정하면 스트림의 기본 LSN이 의미 없는 값으로 설정됩니다.

CLFS 개념 및 용어에 대한 설명은 공통 로그 파일 시스템을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Server 2003 R2, Windows Vista 및 이후 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼 데스크톱
머리글 wdm.h(Wdm.h 포함)
라이브러리 Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

추가 정보

ClfsWriteRestartArea