Функция FltRollbackEnlistment (fltkernel.h)

Статья
06.02.2025

FltRollbackEnlistment подпрограмма отката или прерывания транзакции от имени драйвера минифильтратора.

Синтаксис

NTSTATUS FLTAPI FltRollbackEnlistment(
  [in]           PFLT_INSTANCE Instance,
  [in]           PKTRANSACTION Transaction,
  [in, optional] PFLT_CONTEXT  TransactionContext
);

Параметры

[in] Instance

Указатель непрозрачного экземпляра для вызывающего объекта.

[in] Transaction

Непрозрачный указатель транзакции для транзакции.

[in, optional] TransactionContext

Указатель на контекст транзакции драйвера минифильтра.

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

FltRollbackEnlistment возвращает STATUS_SUCCESS или соответствующее значение NTSTATUS, например одно из следующих:

Возвращаемый код	Описание
STATUS_NOT_FOUND	Драйвер минифильтра не задал контекст транзакции. Это код ошибки.
STATUS_TRANSACTION_REQUEST_NOT_VALID	Запрос отката транзакции не допускается для этого перечисления. Это код ошибки.

Замечания

Драйвер минифильтра, который включен в транзакцию, может вызывать FltRollbackEnlistment для отката или прерывания транзакции.

Чтобы войти в транзакцию, вызовите FltEnlistInTransaction.

Чтобы выделить новый контекст транзакции, вызовите FltAllocateContext.

Чтобы получить контекст транзакции, вызовите FltGetTransactionContext.

Чтобы удалить контекст транзакции, вызовите FltDeleteTransactionContext или FltDeleteContext.

Чтобы задать контекст транзакции, вызовите FltSetTransactionContext.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Эта подпрограмма доступна в Windows Vista и более поздних версиях.
целевая платформа	Всеобщий
заголовка	fltkernel.h (include Fltkernel.h)
библиотеки	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL