Fonction TmPrepareComplete (wdm.h)

La routine TmPrepareComplete informe KTM que le gestionnaire de ressources appelant a terminé la préparation des données d’une transaction.

Syntaxe

NTSTATUS TmPrepareComplete(
  [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.

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

Code de retour	Description
STATUS_TRANSACTION_NOT_REQUESTED	La transaction ou son inscription n’est pas dans l’état correct. Par exemple, KTM n’a pas envoyé de notification TRANSACTION_NOTIFY_PREPREPARE.

La routine peut retourner d’autres valeurs NTSTATUS.

La routine TmPrepareComplete est une version basée sur des pointeurs de la routine ZwPrepareComplete .

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