Функция TmRequestOutcomeEnlistment (wdm.h)

Статья
08/08/2023

Подпрограмма TmRequestOutcomeEnlistment просит KTM попытаться предоставить немедленный результат (фиксацию или откат) для транзакции, связанной с указанным зачислением.

Синтаксис

NTSTATUS TmRequestOutcomeEnlistment(
  [in] PKENLISTMENT   Enlistment,
  [in] PLARGE_INTEGER TmVirtualClock
);

Параметры

[in] Enlistment

Указатель на объект зачисления. Компонент может получать этот указатель в качестве входных данных для процедуры обратного вызова ResourceManagerNotification . Кроме того, компонент может вызвать ObReferenceObjectByHandle и предоставить дескриптор объекта, указанный при предыдущем вызове ZwCreateEnlistment, TmCreateEnlistment или ZwOpenEnlistment .

[in] TmVirtualClock

Указатель на значение виртуальных часов. Этот параметр является необязательным и может иметь значение NULL.

Возвращаемое значение

TmRequestOutcomeEnlistment возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае эта подпрограмма может вернуть следующее значение:

Код возврата	Описание
STATUS_TRANSACTION_REQUEST_NOT_VALID	Указанное зачисление является высшим зачислением.

Подпрограмма может возвращать другие значения NTSTATUS.

Подпрограмма TmRequestOutcomeEnlistment просит KTM предоставить немедленный результат (результат) для транзакции. Диспетчер ресурсов может вызвать TmRequestOutcomeEnlistment после вызова TmPrepareComplete или ZwPrepareComplete, если позже обнаружит, что не может ждать результата, так как, например, произошло неожиданное удаление диска. KTM может принудительно выполнить откат, если все менеджеры ресурсов не завершили свои операции подготовки.

Сведения о том, когда следует использовать подпрограммы KTM TmXxx вместо процедур ZwXxx , см. в разделе Использование подпрограмм TmXxx.

Дополнительные сведения о TmCreateEnlistment см. в разделе Создание Resource Manager.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционной системы.
Целевая платформа	Универсальное
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL