Fonction TmRecoverTransactionManager (wdm.h)

  • Article

La routine TmRecoverTransactionManager reconstruit l’état de l’objet gestionnaire de transactions (y compris toutes les transactions, les inscriptions et les gestionnaires de ressources) à partir des informations de récupération contenues dans le flux de journaux.

Syntaxe

NTSTATUS TmRecoverTransactionManager(
  [in] PKTM           Tm,
  [in] PLARGE_INTEGER TargetVirtualClock
);

Paramètres

[in] Tm

Pointeur vers un objet de gestionnaire de transactions. Pour obtenir ce pointeur, votre composant TPS doit appeler ObReferenceObjectByHandle et fournir le handle d’objet fourni par un appel précédent à ZwCreateTransactionManager ou ZwOpenTransactionManager .

[in] TargetVirtualClock

Pointeur vers une valeur d’horloge virtuelle. Ce paramètre est facultatif et peut être NULL. Pour plus d’informations sur ce paramètre, consultez la section Remarques suivante. Pour Windows Vista, ce paramètre doit avoir la valeur NULL.

Valeur retournée

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

Code de retour Description
STATUS_NOT_IMPLEMENTED
 Pour Windows Vista, l’appelant a spécifié une valeur non NULL pour le paramètre TargetVirtualClock .
STATUS_TM_VOLATILE
 L’objet gestionnaire de transactions spécifié n’a pas de fichier journal. La récupération n’est donc pas disponible.
STATUS_UNSUCCESSFUL
 L’objet gestionnaire de transactions spécifié est dans un état inattendu.
 

La routine peut retourner d’autres valeurs NTSTATUS.

Remarques

La routine TmRecoverTransactionManager est une version basée sur un pointeur de la routine ZwRecoverTransactionManager .

L’appel de TmRecoverTransactionManager avec une valeur de paramètre TargetVirtualClock null équivaut fonctionnellement à l’appel de ZwRecoverTransactionManager. L’appel de TmRecoverTransactionManager avec une valeur de paramètre TargetVirtualClock non NULL équivaut à appeler ZwRollforwardTransactionManager.

Pour plus d’informations sur les opérations de récupération, consultez Gestion des opérations de récupération.

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Vista et les versions ultérieures du système d’exploitation.
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

Voir aussi

ZwRecoverTransactionManager

ZwRollforwardTransactionManager