ZwRollforwardTransactionManager 函数 (wdm.h)
ZwRollforwardTransactionManager 例程为分配给指定事务管理器的所有正在进行的事务启动恢复操作。
语法
NTSYSCALLAPI NTSTATUS ZwRollforwardTransactionManager(
[in] HANDLE TransactionManagerHandle,
[in, optional] PLARGE_INTEGER TmVirtualClock
);
参数
[in] TransactionManagerHandle
事务 管理器对象的 句柄，该对象是通过先前对 ZwCreateTransactionManager 或 ZwOpenTransactionManager 的调用获取的。 句柄必须具有对 对象的TRANSACTIONMANAGER_RECOVER访问权限。
[in, optional] TmVirtualClock
指向 虚拟时钟值的指针。 此参数是可选的，可以为 NULL。 有关此参数的详细信息，请参阅以下“备注”部分。
返回值
如果操作成功，ZwRollforwardTransactionManager 将返回STATUS_SUCCESS。 否则，此例程可能会返回以下值之一：
| 返回代码 | 说明 |
|---|---|
|
指定的句柄不是事务管理器对象的句柄。 |
|
对象句柄无效。 |
|
调用方对事务管理器对象没有适当的访问权限。 |
|
指定的事务管理器对象没有日志文件，因此恢复不可用。 |
|
指定的事务管理器对象处于意外状态。 |
例程可能会返回其他 NTSTATUS 值。
注解
ZwRollforwardTransactionManager 例程恢复 KTM 在事务管理器的日志文件中找到的所有记录活动，最多包括 TmVirtualClock 参数提供的虚拟时钟值。
组件可以通过重复调用 ZwRollforwardTransactionManager 并在每次调用之前将 VirtualClock 参数设置为更高的值，以增量方式遍历日志文件。
如果 TmVirtualClock 参数为 NULL，则调用 ZwRollforwardTransactionManager 等效于调用 ZwRecoverTransactionManager。
有关恢复操作的详细信息，请参阅 处理恢复操作。
NtRollforwardTransactionManager 和 ZwRollforwardTransactionManager 是同一 Windows 本机系统服务例程的两个版本。 内核模式驱动程序无法直接访问 Windows 内核中的 NtRollforwardTransactionManager 例程。 但是，内核模式驱动程序可以通过调用 ZwRollforwardTransactionManager 例程间接访问此例程。
对于来自内核模式驱动程序的调用，Windows Native System Services 例程的 NtXxx 和 ZwXxx 版本在处理和解释输入参数的方式上的行为可能有所不同。 有关例程的 NtXxx 和 ZwXxx 版本之间的关系的详细信息，请参阅 使用本机系统服务例程的 Nt 和 Zw 版本。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Windows Vista 和更高版本的 Windows 中可用。 |
| 目标平台 | 通用 |
| 标头 | wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h） |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 符合性规则 | HwStorPortProhibitedDDI (storport) ， PowerIrpDDis (wdm) |