FltRollbackEnlistment, fonction (fltkernel.h)

Article
02/06/2025

Le FltRollbackEnlistment routine restaure ou abandonne une transaction au nom d’un pilote minifilter.

Syntaxe

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

Paramètres

[in] Instance

Pointeur d’instance opaque pour l’appelant.

[in] Transaction

Pointeur de transaction opaque pour la transaction.

[in, optional] TransactionContext

Pointeur vers le contexte de transaction du pilote minifilter.

Valeur de retour

FltRollbackEnlistment retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, comme l’une des opérations suivantes :

Retourner le code	Description
STATUS_NOT_FOUND	Le pilote minifilter n’a pas défini de contexte sur la transaction. Il s’agit d’un code d’erreur.
STATUS_TRANSACTION_REQUEST_NOT_VALID	La demande de restauration des transactions n’est pas autorisée pour cette inscription. Il s’agit d’un code d’erreur.

Remarques

Un pilote minifilter inscrit dans une transaction peut appeler FltRollbackEnlistment pour restaurer ou abandonner la transaction.

Pour vous inscrire dans une transaction, appelez FltEnlistInTransaction.

Pour allouer un nouveau contexte de transaction, appelez FltAllocateContext.

Pour récupérer un contexte de transaction, appelez FltGetTransactionContext.

Pour supprimer un contexte de transaction, appelez FltDeleteTransactionContext ou FltDeleteContext.

Pour définir un contexte de transaction, appelez FltSetTransactionContext.

Exigences

Exigence	Valeur
client minimum pris en charge	Cette routine est disponible sur Windows Vista et versions ultérieures.
plateforme cible	Universel
d’en-tête	fltkernel.h (include Fltkernel.h)
bibliothèque	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL