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

  • Статья

Подпрограмма ZwRollbackTransaction инициирует операцию отката для указанной транзакции.

Синтаксис

__kernel_entry NTSYSCALLAPI NTSTATUS NtRollbackTransaction(
  [in] HANDLE  TransactionHandle,
  [in] BOOLEAN Wait
);

Параметры

[in] TransactionHandle

Дескриптор объекта транзакции , полученный при предыдущем вызове ZwCreateTransaction или ZwOpenTransaction. Дескриптор должен иметь TRANSACTION_ROLLBACK доступ к объекту .

[in] Wait

Логическое значение, которое вызывающий объект присваивает значение TRUE для синхронной операции или FALSE для асинхронной операции. Если для этого параметра задано значение TRUE, вызов не возвращается до завершения операции отката.

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

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

Код возврата Описание
STATUS_OBJECT_TYPE_MISMATCH
 Дескриптор, который указывает параметр TransactionHandle , не является дескриптором объекта транзакции.
STATUS_INVALID_HANDLE
 Недопустимый дескриптор объекта.
STATUS_ACCESS_DENIED
 Вызывающий объект не имеет соответствующего доступа к объекту транзакции.
STATUS_TRANSACTION_ALREADY_COMMITTED
 Невозможно выполнить откат транзакции, так как она уже зафиксирована.
STATUS_TRANSACTION_REQUEST_NOT_VALID
 Транзакция не была зафиксирована, но ее текущее состояние не допускает отката.
STATUS_PENDING
 Уведомления о откате были поставлены в очередь для диспетчеров ресурсов, а вызывающий объект указал FALSE для параметра Wait .
 

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

Комментарии

Дополнительные сведения о ZwRollbackTransaction см. в разделе Обработка операций отката.

NtRollbackEnlistment и ZwRollbackEnlistment — это две версии одной и той же подпрограммы windows Native System Services.

Для вызовов из драйверов режима ядра версии NtXxx и ZwXxx подпрограммы собственных системных служб Windows могут вести себя по-разному, так как они обрабатывают и интерпретируют входные параметры. Дополнительные сведения о связи между версиями процедуры NtXxx и ZwXxx см. в разделе Использование версий Nt и Zw для процедур собственных системных служб.

Требования

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

См. также раздел

Использование версий Nt и Zw собственных процедур системных служб

ZwCommitTransaction

ZwCreateTransaction

ZwOpenTransaction

ZwQueryInformationTransaction