Condividi tramite


Funzione TmRollbackEnlistment (wdm.h)

La routine TmRollbackEnlistment esegue il rollback di un'integrazione specificata.

Sintassi

NTSTATUS TmRollbackEnlistment(
  [in] PKENLISTMENT   Enlistment,
  [in] PLARGE_INTEGER TmVirtualClock
);

Parametri

[in] Enlistment

Puntatore a un oggetto di integrazione. Il componente può ricevere questo puntatore come input a una routine di callback ResourceManagerNotification . In alternativa, il componente può chiamare ObReferenceObjectByHandle e fornire l'handle dell'oggetto fornito da una chiamata precedente a ZwCreateEnlistment, TmCreateEnlistment o ZwOpenEnlistment .

[in] TmVirtualClock

Puntatore a un valore di clock virtuale. Questo parametro è facoltativo e può essere NULL.

Valore restituito

TmRollbackEnlistment restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa routine potrebbe restituire il valore seguente:

Codice restituito Descrizione
STATUS_TRANSACTION_REQUEST_NOT_VALID
Impossibile eseguire il rollback dell'integrazione.
 

La routine potrebbe restituire altri valori NTSTATUS.

Commenti

La routine TmRollbackEnlistment è una versione basata su puntatore della routine ZwRollbackEnlistment .

Per informazioni su quando usare le routine TmXxx di KTM anziché le routine ZwXxx , vedere Using TmXxx Routines (Uso delle 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

Vedi anche

ObReferenceObjectByHandle

ResourceManagerNotification

TmCreateEnlistment

ZwCreateEnlistment

ZwOpenEnlistment

ZwRollbackEnlistment