PCLFS_CLIENT_ADVANCE_TAIL_CALLBACK 콜백 함수(wdm.h)

  • 아티클

ClfsAdvanceTailCallback 함수는 클라이언트 로그의 LSN(기본 로그 시퀀스 번호)을 이동합니다.

구문

PCLFS_CLIENT_ADVANCE_TAIL_CALLBACK PclfsClientAdvanceTailCallback;

NTSTATUS PclfsClientAdvanceTailCallback(
  [in] PLOG_FILE_OBJECT LogFile,
  [in] PCLFS_LSN TargetLsn,
  [in] PVOID ClientData
)
{...}

매개 변수

[in] LogFile

꼬리가 고급이어야 하는 CLFS 로그 스트림을 나타내는 LOG_FILE_OBJECT 구조체에 대한 포인터입니다.

[in] TargetLsn

클라이언트가 꼬리를 넘어가야 하는 LSN을 포함하는 CLFS_LSN 구조체에 대한 포인터입니다.

[in] ClientData

클라이언트 제공 정보에 대한 포인터입니다. 이 데이터는 CLFS_MGMT_CLIENT_REGISTRATION 구조체의 AdvanceTailCallbackData 멤버에 지정합니다.

반환 값

ClfsAdvanceTailCallback 함수는 STATUS_PENDING 또는 오류 상태 반환해야 합니다. STATUS_PENDING 반환 값은 클라이언트의 로그 테일 이동 요청이 비동기적으로 완료됨을 나타냅니다. ClfsMgmtAdvanceTailCallback 함수는 동기적으로 완료되더라도 STATUS_SUCCESS 반환해서는 안 됩니다.

설명

ClfsAdvanceTailCallback 함수는 CLFS 관리에서 클라이언트가 로그 테일을 진행해달라고 요청할 때 호출됩니다.

ClfsAdvanceTailCallback 함수는 반환하기 전에 최소한의 처리만 수행해야 합니다. 예를 들어 ClfsAdvanceTailCallback 함수는 다음 절차를 따를 수 있습니다.

  1. 요청을 처리할 수 없는 경우 오류 상태 반환합니다.
  2. 요청을 처리할 수 있는 경우 작업 항목을 만들고 큐에 추가하여 클라이언트의 꼬리를 이동하는 데 필요한 작업을 수행한 다음 STATUS_PENDING 반환합니다. 작업자 스레드 큐에 대한 자세한 내용은 시스템 작업자 스레드를 참조하세요.
클라이언트가 CLFS 관리에 등록하기 위해 ClfsMgmtRegisterManagedClient 루틴을 호출하면 클라이언트는 ClfsAdvanceTailCallback 함수에 대한 포인터와 이 함수가 호출될 때 ClfsAdvanceTailCallback 함수에 매개 변수로 전달될 사용자 지정 데이터를 모두 제공합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Server 2003 R2, Windows Vista 및 이후 버전의 Windows에서 지원됩니다.
대상 플랫폼 데스크톱
헤더 wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
IRQL IRQL <= APC_LEVEL 호출

추가 정보

CLFS_MGMT_CLIENT_REGISTRATION

ClfsAdvanceLogBase

ClfsMgmtRegisterManagedClient

ClfsMgmtTailAdvanceFailure