Funzione TmRecoverTransactionManager (wdm.h)

Articolo
07/16/2024

La routine TmRecoverTransactionManager ricostruisce lo stato dell'oggetto di gestione transazioni (incluse tutte le transazioni, le integrazione e i gestori risorse) dalle informazioni di ripristino presenti nel flusso di log.

Sintassi

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

Parametri

[in] Tm

Puntatore a un oggetto di gestione transazioni . Per ottenere questo puntatore, il componente TPS deve chiamare ObReferenceObjectByHandle e fornire l'handle dell'oggetto fornito da una chiamata precedente a ZwCreateTransactionManager o ZwOpenTransactionManager.

[in] TargetVirtualClock

Puntatore a un valore di clock virtuale . Questo parametro è facoltativo e può essere NULL. Per altre informazioni su questo parametro, vedere la sezione Osservazioni seguente. Per Windows Vista, questo parametro deve essere NULL.

Valore restituito

TmRecoverTransactionManager restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa routine potrebbe restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_NOT_IMPLEMENTED	Per Windows Vista, il chiamante ha specificato un valore di NULL nonper il parametro TargetVirtualClock .
STATUS_TM_VOLATILE	L'oggetto di gestione transazioni specificato non dispone di un file di log, pertanto il ripristino non è disponibile.
STATUS_UNSUCCESSFUL	L'oggetto di gestione transazioni specificato è in uno stato imprevisto.

La routine potrebbe restituire altri valori NTSTATUS .

Osservazioni

La routine TmRecoverTransactionManager è una versione basata su puntatore della routine ZwRecoverTransactionManager .

La chiamata di TmRecoverTransactionManager con un valore di parametro TargetVirtualClock di NULL equivale a chiamare ZwRecoverTransactionManager. La chiamata TmRecoverTransactionManager conun valore nullNullTargetVirtualClock parametro equivale a chiamare ZwRollforwardTransactionManager.

Per altre informazioni sulle operazioni di ripristino, vedere Gestione delle operazioni di ripristino.

Per informazioni su quando usare le routine di TmXxx tm anziché ZwXxx, vedere Using TmXxx Routines.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows Vista e versioni successive del sistema operativo.
piattaforma di destinazione	Universale
intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Vedere anche

ZwRecoverTransactionManager

ZwRollforwardTransactionManager

Condividi tramite