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 |
|---|---|
|
L'handle specificato non è un handle per un oggetto transaction manager. |
|
Un handle oggetto non è valido. |
|
Il chiamante non dispone dell'accesso appropriato all'oggetto gestione transazioni. |
|
L'oggetto gestione transazioni è volatile e, pertanto, le relative transazioni non possono essere ripristinate. |
|
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
Uso di nt e zw versioni delle routine di Servizi di sistema nativo