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
指向变量的指针，该变量接收指向不透明读取上下文的指针。 调用方可以将此上下文传递给 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) |
| Library | Clfs.lib |
| DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |