Fonction TmRecoverTransactionManager (wdm.h)
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 |
|---|---|
|
Pour Windows Vista, l’appelant a spécifié une valeur non NULL pour le paramètre TargetVirtualClock . |
|
L’objet gestionnaire de transactions spécifié n’a pas de fichier journal. La récupération n’est donc pas disponible. |
|
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 |