共用方式為


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 型別變數的指標,接收 所指向之數據緩衝區的大小,以位元組為單位。 這是重新啟動記錄的數據緩衝區長度。

[out] plsn

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

[out] ppvReadContext

接收不透明讀取內容指標之變數的指標。 呼叫端可以將此內容傳遞至 ClfsReadPreviousRestartAreaClfsReadNextLogRecord。 當呼叫端使用讀取內容完成時,它必須呼叫 clfsTerminateReadLog 來釋放內容

傳回值

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

言論

如需 CLFS 概念和術語的說明,請參閱 Common Log File System

如需從 CLFS 資料串流讀取記錄的相關信息,請參閱 從 CLFS 資料串流讀取資料記錄 和從 CLFS 資料流讀取重新啟動記錄

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

要求

要求 價值
最低支援的用戶端 適用於 Windows Server 2003 R2、Windows Vista 和更新版本的 Windows。
目標平臺 桌面
標頭 wdm.h (包括 Wdm.h)
連結庫 Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

另請參閱

ClfsCreateMarshallingArea

ClfsReadNextLogRecord

ClfsReadPreviousRestartArea

ClfsTerminateReadLog