Funzione NtRollbackEnlistment (wdm.h)
La routine ZwRollbackEnlistment esegue il rollback della transazione associata a un elenco specificato.
Sintassi
__kernel_entry NTSYSCALLAPI NTSTATUS NtRollbackEnlistment(
[in] HANDLE EnlistmentHandle,
[in, optional] PLARGE_INTEGER TmVirtualClock
);
Parametri
[in] EnlistmentHandle
Handle a un oggetto enlistment ottenuto da una chiamata precedente a ZwCreateEnlistment o ZwOpenEnlistment. L'handle deve avere ENLISTMENT_SUBORDINATE_RIGHTS accesso all'oggetto.
[in, optional] TmVirtualClock
Puntatore a un valore di orologio virtuale. Questo parametro è facoltativo e può essere NULL.
Valore restituito
ZwRollbackEnlistment 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 enlistment. |
|
L'handle dell'oggetto non è valido. |
|
Impossibile eseguire il rollback dell'elenco. |
|
Il chiamante non dispone dell'accesso appropriato all'oggetto enlistment. |
La routine potrebbe restituire altri valori NTSTATUS.
Commenti
Un gestore risorse può chiamare ZwRollbackEnlistment per eseguire il rollback di una transazione in qualsiasi momento prima di chiamare ZwPrepareComplete.
Per altre informazioni su ZwRollbackEnlistment, vedere Gestione delle operazioni di rollback.
NtRollbackEnlistment e ZwRollbackEnlistment 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