Fonction TmRecoverEnlistment (wdm.h)

Article
02/27/2024

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
STATUS_OBJECT_TYPE_MISMATCH	Le handle spécifié n’est pas un handle pour un objet d’inscription.
STATUS_INVALID_HANDLE	Un handle d’objet n’est pas valide.
STATUS_TRANSACTION_REQUEST_NOT_VALID	La transaction ou son inscription n’est pas dans l’état correct.
STATUS_PENDING	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