NtRollforwardTransactionManager 函数 (wdm.h)
ZwRollforwardTransactionManager 例程针对分配给指定事务管理器的所有正在进行的事务启动恢复操作。
语法
__kernel_entry NTSYSCALLAPI NTSTATUS NtRollforwardTransactionManager(
[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 本机系统服务例程的 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，PowerIrpDDis |