Fonction TmRecoverEnlistment (wdm.h)
La routine TmRecoverEnlistment lance une opération de récupération pour la transaction associée à une inscription spécifiée.
Syntaxe
NTSTATUS TmRecoverEnlistment(
[in] PKENLISTMENT Enlistment,
[in] PVOID EnlistmentKey
);
Paramètres
[in] Enlistment
Pointeur vers un objet d’inscription. Votre composant peut recevoir ce pointeur en tant qu’entrée dans 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] EnlistmentKey
Pointeur vers la valeur de la clé d’inscription que le gestionnaire de ressources a précédemment spécifiée en tant que paramètre EnlistmentKey vers ZwCreateEnlistment ou TmCreateEnlistment. Ce paramètre est facultatif et peut être NULL si le gestionnaire de ressources n’a pas fourni de clé d’inscription lorsqu’il a appelé ZwCreateEnlistment ou TmCreateEnlistment.
Valeur retournée
TmRecoverEnlistment retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette routine peut retourner l’une des valeurs suivantes :
Code de retour | Description |
---|---|
|
Le handle spécifié n’est pas un handle pour un objet d’inscription. |
|
Un handle d’objet n’est pas valide. |
|
La transaction ou son inscription n’est pas dans l’état correct. |
|
KTM a ajouté une notification de validation, de restauration ou de doute à la file d’attente de notification du gestionnaire de ressources, et le gestionnaire de ressources n’utilise pas de routine de rappel ResourceManagerNotification . |
La routine peut retourner d’autres valeurs NTSTATUS.
Remarques
La routine TmRecoverEnlistment est une version basée sur un pointeur de la routine ZwRecoverEnlistment .
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 les opérations de récupération, consultez Gestion des opérations de récupération.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Disponible dans Windows Vista et les versions plus récentes de Windows. |
Plateforme cible | Universal |
En-tête | wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h) |
Bibliothèque | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |