ClfsReadRestartArea 函式 (wdm.h)

ClfsReadRestartArea 例程會讀取最近寫入指定 CLFS 數據流的重新啟動記錄。

語法

CLFSUSER_API NTSTATUS ClfsReadRestartArea(
  [in, out] PVOID     pvMarshalContext,
  [out]     PVOID     *ppvRestartBuffer,
  [out]     PULONG    pcbRestartBuffer,
  [out]     PCLFS_LSN plsn,
  [out]     PVOID     *ppvReadContext
);

參數

[in, out] pvMarshalContext

不透明內容的指標，表示與CLFS數據流相關聯的封送處理區域。 呼叫端先前藉由呼叫 ClfsCreateMarshallingArea 來取得此指標。

[out] ppvRestartBuffer

變數的指標，接收重新啟動記錄之數據緩衝區的指標。

[out] pcbRestartBuffer

ULONG 型別變數的指標，可接收 由 azurerestartBuffer 指向之數據緩衝區的大小，以位元組為單位。 這是重新啟動記錄的數據緩衝區長度。

[out] plsn

接收已讀取之重新啟動記錄 LSN 之CLFS_LSN結構的指標。

[out] ppvReadContext

接收不透明讀取內容指標之變數的指標。 呼叫端可以將此內容傳遞至 ClfsReadPreviousRestartArea 或 ClfsReadNextLogRecord。 當呼叫端使用讀取內容完成時，它必須藉由呼叫 ClfsTerminateReadLog 釋放內容。

傳回值

ClfsReadRestartArea 會在成功時傳回STATUS_SUCCESS;否則，它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。

備註

如需CLFS概念和術語的說明，請參閱 一般記錄檔系統。

如需從 CLFS 數據流讀取記錄的相關信息，請參閱從 CLFS 讀取數據記錄 Stream 和從 CLFS 讀取重新啟動記錄 Stream。

讀取內容不是安全線程。 用戶端負責串行化讀取內容的存取權。

規格需求

需求	值
最低支援的用戶端	適用於 Windows Server 2003 R2、Windows Vista 和更新版本的 Windows。
目標平台	桌面
標頭	wdm.h (包含 Wdm.h)
程式庫	Clfs.lib
Dll	Clfs.sys
IRQL	<= APC_LEVEL

另請參閱

ClfsCreateMarshallingArea

ClfsReadNextLogRecord

ClfsReadPreviousRestartArea

ClfsTerminateReadLog