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

LOG_FILE_OBJECT 結構的指標，表示其結尾應為進階的CLFS記錄數據流。

[in] TargetLsn

CLFS_LSN 結構的指標，其中包含客戶端應該將其尾端往前移至或更新的 LSN。

[in] ClientData

用戶端提供的資訊指標。 您可以在 CLFS_MGMT_CLIENT_REGISTRATION 結構的 AdvanceTailCallbackData 成員中指定此數據。

傳回值

ClfsAdvanceTailCallback 函式應該會傳回STATUS_PENDING或錯誤狀態。 STATUS_PENDING傳回值表示將異步完成行動客戶端記錄尾的要求。 ClfsMgmtAdvanceTailCallback 函式不得傳回STATUS_SUCCESS，即使它以同步方式完成也一樣。

備註

ClfsAdvanceTailCallback 函式會在CLFS管理要求客戶端前進其記錄尾端時呼叫。

ClfsAdvanceTailCallback 函式只能在傳回之前執行最少的處理。 例如， ClfsAdvanceTailCallback 函式可能會遵循此程式：

1. 如果無法處理要求，則傳回錯誤狀態。
2. 如果可以處理要求，請建立工作專案並排入佇列，以執行行動用戶端結尾所需的動作，然後傳回STATUS_PENDING。 如需佇列背景工作線程的詳細資訊，請參閱 系統背景工作線程。

當用戶端呼叫 ClfsMgmtRegisterManagedClient 例程以向 CLFS 管理註冊時，用戶端會同時提供 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