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