Funzione NtRecoverTransactionManager (wdm.h)

La routine ZwRecoverTransactionManager ricostruisce lo stato dell'oggetto transaction manager (incluse tutte le transazioni, gli elenchi e i responsabili delle risorse) dalle informazioni di ripristino presenti nel flusso di log.

Sintassi

__kernel_entry NTSYSCALLAPI NTSTATUS NtRecoverTransactionManager(
  [in] HANDLE TransactionManagerHandle
);

Parametri

[in] TransactionManagerHandle

Handle a un oggetto di gestione transazioni ottenuto da una chiamata precedente a ZwCreateTransactionManager o ZwOpenTransactionManager. L'handle deve avere TRANSACTIONMANAGER_RECOVER accesso all'oggetto.

Valore restituito

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

Codice restituito	Descrizione
STATUS_OBJECT_TYPE_MISMATCH	L'handle specificato non è un handle per un oggetto transaction manager.
STATUS_INVALID_HANDLE	Un handle oggetto non è valido.
STATUS_ACCESS_DENIED	Il chiamante non dispone dell'accesso appropriato all'oggetto gestione transazioni.
STATUS_TM_VOLATILE	L'oggetto gestione transazioni è volatile e, pertanto, le relative transazioni non possono essere ripristinate.
STATUS_UNSUCCESSFUL	L'oggetto gestione transazioni non è in uno stato che consente il ripristino.

 

La routine potrebbe restituire altri valori NTSTATUS.

Commenti

La routine ZwRecoverTransactionManager tenta di ricostruire lo stato dell'oggetto di gestione transazioni, incluse tutte le transazioni, gli elenchi e i responsabili delle risorse, dalle informazioni di ripristino presenti nel flusso di log dell'oggetto, a partire dall'ultima area di riavvio creata da KTM e terminando alla fine del flusso.

Per ripristinare un tempo virtuale specifico, usare la routine ZwRollforwardTransactionManager anziché ZwRecoverTransactionManager.

Il componente TPS deve chiamare ZwRecoverTransactionManager dopo aver chiamato ZwCreateTransactionManager o ZwOpenTransactionManager.

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

NtRecoverTransactionManager e ZwRecoverTransactionManager sono due versioni della stessa routine di Windows Native System Services.

Per le chiamate dai driver in modalità kernel, le versioni NtXxx e ZwXxx di una routine di Windows Native System Services possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Uso di nt e zw versioni delle routine di Servizi di sistema nativo.

Requisiti

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, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	HwStorPortProhibitedDDIs, PowerIrpDDis

Vedi anche

TmRecoverTransactionManager

Uso di nt e zw versioni delle routine di Servizi di sistema nativo

ZwCreateTransactionManager

ZwOpenTransactionManager

ZwRollforwardTransactionManager