Fonction NtRollbackTransaction (wdm.h)

  • Article

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

Syntaxe

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

Paramètres

[in] TransactionHandle

Handle d’un objet de transaction obtenu par un appel précédent à ZwCreateTransaction ou ZwOpenTransaction. Le handle doit avoir TRANSACTION_ROLLBACK accès à l’objet.

[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 a la valeur TRUE, l’appel ne retourne pas tant que l’opération de restauration n’est pas terminée.

Valeur retournée

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

Code de retour Description
STATUS_OBJECT_TYPE_MISMATCH
 Le handle spécifié par le paramètre TransactionHandle n’est pas un handle pour un objet de transaction.
STATUS_INVALID_HANDLE
 Un handle d’objet n’est pas valide.
STATUS_ACCESS_DENIED
 L’appelant n’a pas l’accès approprié à l’objet de transaction.
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

Pour plus d’informations sur ZwRollbackTransaction, consultez Gestion des opérations de restauration.

NtRollbackEnlistment et ZwRollbackEnlistment sont deux versions de la même routine Windows Native System Services.

Pour les appels à partir de pilotes en mode noyau, les versions NtXxx et ZwXxx d’une routine Windows Native System Services peuvent se comporter différemment dans la façon dont elles gèrent et interprètent les paramètres d’entrée. Pour plus d’informations sur la relation entre les versions NtXxx et ZwXxx d’une routine, consultez Utilisation des versions Nt et Zw des routines des services système natifs.

Configuration requise

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

Voir aussi

Utilisation des versions Nt et Zw des routines natives des services système natifs

ZwCommitTransaction

ZwCreateTransaction

ZwOpenTransaction

ZwQueryInformationTransaction