TmRequestOutcomeEnlistment 函数 (wdm.h)
TmRequestOutcomeEnlistment 例程要求 KTM 尝试为与指定登记关联的事务 (提交或回滚) 提供即时结果。
语法
NTSTATUS TmRequestOutcomeEnlistment(
[in] PKENLISTMENT Enlistment,
[in] PLARGE_INTEGER TmVirtualClock
);
参数
[in] Enlistment
指向 登记对象的指针。 组件可以接收此指针作为 ResourceManagerNotification 回调例程的输入。 或者，组件可以调用 ObReferenceObjectByHandle ，并提供以前对 ZwCreateEnlistment、 TmCreateEnlistment 或 ZwOpenEnlistment 的调用提供的对象句柄。
[in] TmVirtualClock
指向 虚拟时钟值的指针。 此参数是可选的，可以为 NULL。
返回值
如果操作成功，TmRequestOutcomeEnlistment 将返回STATUS_SUCCESS。 否则，此例程可能会返回以下值：
| 返回代码 | 说明 |
|---|---|
|
指定的登记是 高级登记。 |
例程可能会返回其他 NTSTATUS 值。
注解
TmRequestOutcomeEnlistment 例程要求 KTM 尝试为事务提供即时结果 (结果) 。 如果资源管理器在调用 TmPrepareComplete 或 ZwPrepareComplete 后调用 TmRequestOutcomeEnlistment，如果后来发现无法等待结果，例如，磁盘意外删除。 如果所有资源管理器尚未完成其准备操作，KTM 可能能够强制回滚。
有关何时使用 KTM 的 TmXxx 例程而不是 ZwXxx 例程的信息，请参阅 使用 TmXxx 例程。
有关 TmCreateEnlistment 的详细信息，请参阅创建资源管理器。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Windows Vista 和更高版本的操作系统中可用。 |
| 目标平台 | 通用 |
| 标头 | wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h） |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |