Função TmRollbackTransaction (wdm.h)

  • Artigo

A rotina TmRollbackTransaction inicia uma operação de reversão para uma transação especificada.

Sintaxe

NTSTATUS TmRollbackTransaction(
  [in] PKTRANSACTION Transaction,
  [in] BOOLEAN       Wait
);

Parâmetros

[in] Transaction

Um ponteiro para um objeto de transação. Para obter esse ponteiro, seu componente deve chamar ObReferenceObjectByHandle e fornecer o identificador de objeto fornecido por uma chamada anterior para ZwCreateTransaction ou ZwOpenTransaction .

[in] Wait

Um valor booliano que o chamador define como TRUE para operação síncrona ou FALSE para operação assíncrona. Se esse parâmetro for definido como TRUE, a chamada não retornará até que a operação de reversão seja concluída.

Retornar valor

TmRollbackTransaction retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa rotina pode retornar um dos seguintes valores:

Código de retorno Descrição
STATUS_TRANSACTION_ALREADY_COMMITTED
 A transação não pode ser revertida porque já foi confirmada.
STATUS_TRANSACTION_REQUEST_NOT_VALID
 A transação não foi confirmada, mas seu estado atual não permite a reversão.
STATUS_PENDING
 As notificações de reversão foram enfileiradas para gerenciadores de recursos e o chamador especificou FALSE para o parâmetro Wait .
 

A rotina pode retornar outros valores NTSTATUS.

Comentários

A rotina TmRollbackTransaction é uma versão baseada em ponteiro da rotina ZwRollbackTransaction .

Para obter informações sobre quando usar as rotinas TmXxx da KTM em vez de rotinas ZwXxx , consulte Usando rotinas TmXxx.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores do sistema operacional.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Confira também

ObReferenceObjectByHandle

ZwCreateTransaction

ZwOpenTransaction

ZwRollbackTransaction