Partager via


Fonction ZwCommitTransaction (wdm.h)

La routine ZwCommitTransaction lance une opération de validation pour une transaction spécifiée.

Syntaxe

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

Paramètres

[in] TransactionHandle

Handle d’un objet de transaction. Votre composant reçoit ce handle de ZwCreateTransaction ou ZwOpenTransaction. Le handle doit avoir TRANSACTION_COMMIT 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 est retourné une fois l’opération de validation terminée.

Valeur retournée

ZwCommitTransaction 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 qui a été spécifié pour le paramètre TransactionHandle n’est pas un handle pour un objet de transaction.
STATUS_INVALID_HANDLE
Le handle de l’objet transaction spécifié n’est pas valide.
STATUS_ACCESS_DENIED

L’appelant n’a pas l’accès approprié à l’objet de transaction.

STATUS_TRANSACTION_SUPERIOR_EXISTS
L’appelant ne peut pas valider la transaction, car il existe un gestionnaire de transactions supérieur .
STATUS_TRANSACTION_ALREADY_ABORTED
La transaction ne peut pas être validée, car elle a été restaurée.
STATUS_TRANSACTION_ALREADY_COMMITTED
La transaction est déjà validée.
STATUS_TRANSACTION_REQUEST_NOT_VALID
L’opération de validation de cette transaction a déjà été démarrée.
STATUS_PENDING
Les notifications de validation 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 la façon dont les clients de transaction doivent utiliser la routine ZwCommitTransaction , consultez Création d’un client transactionnel.

Pour plus d’informations sur les opérations de validation, consultez Gestion des opérations de validation.

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 plus récentes de Windows.
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(storport),PowerIrpDDis(wdm)

Voir aussi

TmCommitTransaction

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

ZwCreateTransaction

ZwOpenTransaction