共用方式為


PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK回呼函式 (wdm.h)

ClfsLogGrowthCompleteCallback 函式會實作用戶端在先前已滿的記錄檔中釋放空間時將採取的動作。

語法

PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK PclfsClientLffHandlerCompleteCallback;

void PclfsClientLffHandlerCompleteCallback(
  [in] PLOG_FILE_OBJECT LogFile,
  [in] NTSTATUS OperationStatus,
  [in] BOOLEAN LogIsPinned,
  [in] PVOID ClientData
)
{...}

參數

[in] LogFile

LOG_FILE_OBJECT 結構的指標,代表記錄檔已完成成長的CLFS記錄數據流。

[in] OperationStatus

用戶端先前要求處理記錄檔完整條件的狀態。 這會是STATUS_SUCCESS或錯誤狀態,指出要求無法順利完成的原因。

[in] LogIsPinned

如果 為 TRUE,則指定記錄尾目前已釘選;如果記錄尾未釘選,則為 FALSE

[in] ClientData

用戶端提供資訊的指標。

傳回值

備註

因為對 ClfsMgmtHandleLogFileFull 的呼叫會以異步方式完成,所以當記錄檔完整條件已處理到 ClfsLogGrowthCompleteCallback 函式時,用戶端將採取的任何動作。

如果傳回 ClfsMgmtHandleLogFileFull 例程的呼叫會傳回STATUS_PENDING,則會在作業完成時叫用 ClfsLogGrowthCompleteCallback 函式。 如果傳回不同的狀態,將不會叫用 ClfsLogGrowthCompleteCallback 函式。

ClfsLogGrowthCompleteCallback 函式應該只會在傳回之前執行最少的處理。 例如, ClfsLogGrowthCompleteCallback 函式可能會遵循下列程式:

  1. 如果 OperationStatus 參數的值是錯誤狀態,則傳回 。
  2. 如果 OperationStatus 參數的值STATUS_SUCCESS,請建立工作專案並排入佇列,通知用戶端可以繼續處理。
當用戶端使用 ClfsMgmtRegisterManagedClient 例程向 CLFS 管理註冊時,用戶端會在呼叫此函式時提供 ClfsLogGrowthCompleteCallback 函式的指標,以及將做為參數傳遞至 ClfsLogGrowthCompleteCallback 函式的自定義數據。

規格需求

需求
最低支援的用戶端 Windows Server 2003 R2、Windows Vista 和更新版本的 Windows 支援。
目標平台 桌面
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
IRQL 在 IRQL <= APC_LEVEL呼叫

另請參閱

ClfsMgmtHandleLogFileFull

ClfsMgmtRegisterManagedClient