TmCommitEnlistment, fonction (wdm.h)

La routine TmCommitEnlistment lance l’opération de validation pour la transaction d’inscription spécifiée.

Syntaxe

NTSTATUS TmCommitEnlistment(
  [in] PKENLISTMENT   Enlistment,
  [in] PLARGE_INTEGER TmVirtualClock
);

[in] Enlistment

Pointeur vers un objet d’inscription. Votre composant peut recevoir ce pointeur en tant qu’entrée d’une routine de rappel ResourceManagerNotification . Votre composant peut également appeler ObReferenceObjectByHandle et fournir le handle d’objet fourni par un appel précédent à ZwCreateEnlistment, TmCreateEnlistment ou ZwOpenEnlistment .

[in] TmVirtualClock

Pointeur vers une valeur d’horloge virtuelle. Ce paramètre est facultatif et peut être NULL.

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

Code de retour	Description
STATUS_ENLISTMENT_NOT_SUPERIOR	L’appelant n’est pas un gestionnaire de transactions supérieur pour l’inscription.
STATUS_TRANSACTION_RESPONSE_NOT_ENLISTED	L’appelant ne s’est pas inscrit pour recevoir TRANSACTION_NOTIFY_COMMIT_COMPLETE notifications.
STATUS_TRANSACTION_REQUEST_NOT_VALID	La transaction de l’enrôlement n’est pas dans un état qui lui permet d’être validée.
STATUS_TRANSACTION_NOT_ACTIVE	L’opération de validation de cette transaction a déjà été démarrée.
STATUS_TRANSACTION_ALREADY_ABORTED	La transaction ne peut pas être validée, car elle a été restaurée.

La routine peut retourner d’autres valeurs NTSTATUS.

La routine TmCommitEnlistment est une version basée sur des pointeurs de la routine ZwCommitEnlistment .

Seuls les gestionnaires de transactions supérieurs peuvent appeler TmCommitEnlistment.

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

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