TmRollbackTransaction, fonction (wdm.h)

  • Article

La routine TmRollbackTransaction lance une opération de restauration pour une transaction spécifiée.

Syntaxe

NTSTATUS TmRollbackTransaction(
  [in] PKTRANSACTION Transaction,
  [in] BOOLEAN       Wait
);

Paramètres

[in] Transaction

Pointeur vers un objet de transaction. Pour obtenir ce pointeur, votre composant doit appeler ObReferenceObjectByHandle et fournir le handle d’objet fourni par un appel précédent à ZwCreateTransaction ou ZwOpenTransaction .

[in] Wait

Valeur booléenne que l’appelant définit sur TRUE pour l’opération synchrone ou FALSE pour l’opération asynchrone. Si ce paramètre est défini sur TRUE, l’appel ne retourne pas tant que l’opération de restauration n’est pas terminée.

Valeur retournée

TmRollbackTransaction retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette routine peut retourner l’une des valeurs suivantes :

Code de retour Description
STATUS_TRANSACTION_ALREADY_COMMITTED
 La transaction ne peut pas être restaurée, car elle a déjà été validée.
STATUS_TRANSACTION_REQUEST_NOT_VALID
 La transaction n’a pas été validée, mais son état actuel n’autorise pas la restauration.
STATUS_PENDING
 Les notifications de restauration ont été mises en file d’attente vers les gestionnaires de ressources, et l’appelant a spécifié FALSE pour le paramètre Wait .
 

La routine peut retourner d’autres valeurs NTSTATUS.

Remarques

La routine TmRollbackTransaction est une version basée sur des pointeurs de la routine ZwRollbackTransaction .

Pour plus d’informations sur l’utilisation des routines TmXxx de KTM au lieu des routines ZwXxx , consultez Utilisation des routines TmXxx.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Vista et versions ultérieures du système d’exploitation.
Plateforme cible Universal
En-tête wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Voir aussi

ObReferenceObjectByHandle

ZwCreateTransaction

ZwOpenTransaction

ZwRollbackTransaction