ClfsReadNextLogRecord 函式 (wdm.h)

ClfsReadNextLogRecord 例程會讀取序列中的下一筆記錄，相對於讀取內容中的目前記錄。

語法

CLFSUSER_API NTSTATUS ClfsReadNextLogRecord(
  [in, out]      PVOID             pvReadContext,
  [out]          PVOID             *ppvBuffer,
  [out]          PULONG            pcbBuffer,
  [in, out]      PCLFS_RECORD_TYPE peRecordType,
  [in, optional] PCLFS_LSN         plsnUser,
  [out]          PCLFS_LSN         plsnUndoNext,
  [out]          PCLFS_LSN         plsnPrevious,
  [out]          PCLFS_LSN         plsnRecord
);

參數

[in, out] pvReadContext

呼叫 ClfsReadLogRecord 或 ClfsReadRestartArea 先前取得之呼叫端所取得之讀取內容的指標。

[out] ppvBuffer

變數的指標，可接收包含記錄數據的緩衝區指標。

[out] pcbBuffer

ULONG 型別變數的指標，可接收 *ppvBuffer 所指向之緩衝區的大小，以位元組為單位。 這是讀取記錄的數據緩衝區長度。

[in, out] peRecordType

CLFS_RECORD_TYPE類型的變數指標。 呼叫端必須將此參數設定為下列其中一個值。

值	將讀取的記錄
ClfsDataRecord	下一筆數據記錄。
ClfsRestartRecord	下一個重新啟動記錄。
ClfsClientRecord	下一筆記錄是數據記錄或重新啟動記錄。

[in, optional] plsnUser

CLFS_LSN 結構的指標 ，提供要讀取之記錄的 LSN。 會讀取指定的記錄，而不是 (根據 clfsContextUndoNext、 ClfsContextPrevious 或 ClfsContextFor) ward 讀取內容 (pvReadContext) 模式讀取的記錄。 plsnUser 中提供的 LSN 必須小於讀取內容的目前 LSN。 此參數可以是 Null。

[out] plsnUndoNext

CLFS_LSN 結構的指標 ，可接收讀取之記錄的復原下一個 LSN。

[out] plsnPrevious

CLFS_LSN 結構的指標 ，該結構會接收已讀取之記錄的先前 LSN。

[out] plsnRecord

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

傳回值

ClfsReadNextLogRecord 如果成功，則會傳回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

另請參閱

CLFS_LSN

ClfsReadLogRecord

ClfsReadRestartArea