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 함수는 다음 절차를 따를 수 있습니다.
- 요청을 처리할 수 없는 경우 오류 상태 반환합니다.
- 요청을 처리할 수 있는 경우 작업 항목을 만들고 큐에 추가하여 클라이언트의 꼬리를 이동하는 데 필요한 작업을 수행한 다음 STATUS_PENDING 반환합니다. 작업자 스레드 큐에 대한 자세한 내용은 시스템 작업자 스레드를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Server 2003 R2, Windows Vista 및 이후 버전의 Windows에서 지원됩니다. |
| 대상 플랫폼 | 데스크톱 |
| 헤더 | wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함) |
| IRQL | IRQL <= APC_LEVEL 호출 |