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,即使它以同步方式完成也一樣。

言論

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

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