TmRequestOutcomeEnlistment, fonction (wdm.h)

Article
03/01/2024

La routine TmRequestOutcomeEnlistment demande à KTM d’essayer de fournir un résultat immédiat (validation ou restauration) pour la transaction associée à un enrôlement spécifié.

Syntaxe

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

Paramètres

[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.

Valeur retournée

TmRequestOutcomeEnlistment retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette routine peut retourner la valeur suivante :

Code de retour	Description
STATUS_TRANSACTION_REQUEST_NOT_VALID	L’inscription spécifiée est une inscription supérieure.

La routine peut retourner d’autres valeurs NTSTATUS.

Remarques

La routine TmRequestOutcomeEnlistment demande à KTM d’essayer de fournir un résultat immédiat (résultat) pour la transaction. Un gestionnaire de ressources peut appeler TmRequestOutcomeEnlistment après avoir appelé TmPrepareComplete ou ZwPrepareComplete, s’il découvre ultérieurement qu’il ne peut pas attendre un résultat, car, par exemple, une suppression surprise du disque s’est produite. KTM peut être en mesure de forcer une restauration si tous les gestionnaires de ressources n’ont pas terminé leurs opérations de préparation.

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

Pour plus d’informations sur TmCreateEnlistment, consultez Création d’un Resource Manager.

Configuration requise

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