TmRequestOutcomeEnlistment, fonction (wdm.h)
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 |
---|---|
|
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 |