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 类型变量的指针,该变量接收 由httpRestartBuffer指向的数据缓冲区的大小(以字节为单位)。 这是重启记录的数据缓冲区的长度。

[out] plsn

指向CLFS_LSN 结构的指针,该结构接收已读取的重启记录的 LSN。

[out] ppvReadContext

指向变量的指针,该变量接收指向不透明读取上下文的指针。 调用方可以将此上下文传递给 ClfsReadPreviousRestartAreaClfsReadNextLogRecord。 调用方完成使用读取上下文后,必须通过调用 ClfsTerminateReadLog 释放上下文。

返回值

如果成功,ClfsReadRestartArea 将返回STATUS_SUCCESS;否则,它将返回 Ntstatus.h 中定义的错误代码之一。

注解

有关 CLFS 概念和术语的说明,请参阅 通用日志文件系统

有关从 CLFS 流读取记录的信息,请参阅从 CLFS Stream读取数据记录从 CLFS Stream读取重启记录

读取上下文不是线程安全的。 客户端负责序列化对读取上下文的访问。

要求

要求
最低受支持的客户端 在 Windows Server 2003 R2、Windows Vista 和更高版本的 Windows 中可用。
目标平台 桌面
标头 wdm.h (包括 Wdm.h)
Library Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

另请参阅

ClfsCreateMarshallingArea

ClfsReadNextLogRecord

ClfsReadPreviousRestartArea

ClfsTerminateReadLog