TmRollbackTransaction, fonction (wdm.h)
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 |
|---|---|
|
La transaction ne peut pas être restaurée, car elle a déjà été validée. |
|
La transaction n’a pas été validée, mais son état actuel n’autorise pas la restauration. |
|
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 |