Fonction NtCommitTransaction (wdm.h)
La routine ZwCommitTransaction lance une opération de validation pour une transaction spécifiée.
__kernel_entry NTSYSCALLAPI NTSTATUS NtCommitTransaction(
[in] HANDLE TransactionHandle,
[in] BOOLEAN Wait
);
[in] TransactionHandle
Handle vers 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 FAUX pour l’opération asynchrone. Si ce paramètre est TRUE, l’appel retourne une fois l’opération de validation terminée.
ZwCommitTransaction retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette routine peut retourner l’une des valeurs suivantes :
Retourner le code | Description |
---|---|
|
Le handle spécifié pour le paramètre TransactionHandle n’est pas un handle pour un objet transactionnel. |
|
Le handle d’objet de transaction spécifié n’est pas valide. |
|
L’appelant n’a pas d’accès approprié à l’objet transactionnel. |
|
L’appelant ne peut pas valider la transaction, car un gestionnaire de transactions supérieur existe. |
|
La transaction ne peut pas être validée, car elle a été restaurée. |
|
La transaction est déjà validée. |
|
L’opération de validation pour cette transaction a déjà été démarrée. |
|
Les notifications de validation ont été mises en file d’attente vers les gestionnaires de ressources, et l’appelant spécifié faux pour le paramètre Wait. |
La routine peut retourner d’autres valeurs NTSTATUS .
Pour plus d’informations sur la façon dont les clients de transactions doivent utiliser la routine ZwCommitTransaction, consultez Création d’unclient 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 de 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 Using Nt and Zw Versions of the Native System Services Routines.
Exigence | Valeur |
---|---|
client minimum pris en charge | Disponible dans Windows Vista et versions ultérieures de Windows. |
plateforme cible | Universel |
d’en-tête | wdm.h (include Wdm.h, Ntifs.h) |
bibliothèque | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
règles de conformité DDI | HwStorPortProhibitedDDIs, PowerIrpDDis |
à l’aide de versions Nt et Zw des routines natives des services système