Funzione TmRollbackTransaction (wdm.h)
La routine TmRollbackTransaction avvia un'operazione di rollback per una transazione specificata.
Sintassi
NTSTATUS TmRollbackTransaction(
[in] PKTRANSACTION Transaction,
[in] BOOLEAN Wait
);
Parametri
[in] Transaction
Puntatore a un oggetto transazione. Per ottenere questo puntatore, il componente deve chiamare ObReferenceObjectByHandle e specificare l'handle dell'oggetto che una chiamata precedente a ZwCreateTransaction o ZwOpenTransaction fornita.
[in] Wait
Valore booleano impostato sul chiamante su TRUE per l'operazione sincrona o FALSE per l'operazione asincrona. Se questo parametro è impostato su TRUE, la chiamata non viene restituita fino al completamento dell'operazione di rollback.
Valore restituito
TmRollbackTransaction restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa routine potrebbe restituire uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Impossibile eseguire il rollback della transazione perché è già stato eseguito il commit. |
|
La transazione non è stata eseguita il commit, ma lo stato corrente non consente il rollback. |
|
Le notifiche di rollback sono state accodate a gestione risorse e il chiamante ha specificato FALSE per il parametro Wait . |
La routine potrebbe restituire altri valori NTSTATUS.
Commenti
La routine TmRollbackTransaction è una versione basata su puntatore della routine ZwRollbackTransaction .
Per informazioni su quando usare le routine TmXxx di KTM anziché le routine Zw Xxx, vedere Uso di routine TmXxx.
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, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |