Funzione NtRecoverTransactionManager (wdm.h)
La routine ZwRecoverTransactionManager 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
__kernel_entry NTSYSCALLAPI NTSTATUS NtRecoverTransactionManager(
[in] HANDLE TransactionManagerHandle
);
Parametri
[in] TransactionManagerHandle
Handle per 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 |
|---|---|
|
L'handle specificato non è un handle per un oggetto di gestione transazioni. |
|
Un handle di oggetto non è valido. |
|
Il chiamante non dispone dell'accesso appropriato all'oggetto di gestione transazioni. |
|
L'oggetto di gestione transazioni è volatile e pertanto non è possibile recuperarne le transazioni. |
|
L'oggetto gestione transazioni non è in uno stato che consente il ripristino. |
La routine potrebbe restituire altri valori NTSTATUS .
Osservazioni
La routine ZwRecoverTransactionManager tenta di ricostruire lo stato dell'oggetto di gestione transazioni, incluse tutte le transazioni, gli inserimenti e i gestori risorse, dalle informazioni di ripristino contenute nel flusso di log dell'oggetto, a partire dall'ultima area di riavvio che KTM ha creato e termina alla fine del flusso.
Per ripristinare fino a un'ora virtuale specifica, 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 Servizi di sistema nativi di Windows.
Per le chiamate da driver in modalità kernel, le NtXxx e ZwXxx versioni 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 Using Nt and Zw Versions of the Native System Services 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, Ntifs.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| regole di conformità DDI | HwStorPortProhibitedDDIs, PowerIrpDDis |
Vedere anche
uso di versioni Nt e Zw delle routine di Servizi di sistema nativi