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 |