Função TmCommitTransaction (wdm.h)

  • Artigo

A rotina TmCommitTransaction inicia uma operação de confirmação para uma transação especificada.

Sintaxe

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

Parâmetros

[in] Transaction

Um ponteiro para um objeto de transação. Para obter esse ponteiro, o componente TPS 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 TRUE, a chamada retornará após a conclusão da operação de confirmação.

Retornar valor

TmCommitTransaction 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_SUPERIOR_EXISTS
 O chamador não pode confirmar a transação porque existe um gerenciador de transações superior .
STATUS_TRANSACTION_ALREADY_ABORTED
 A transação não pode ser confirmada porque foi revertida.
STATUS_TRANSACTION_ALREADY_COMMITTED
 A transação já está confirmada.
STATUS_TRANSACTION_REQUEST_NOT_VALID
 A operação de confirmação para essa transação já foi iniciada.
STATUS_PENDING
 As notificações de confirmaçã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 TmCommitTransaction é uma versão baseada em ponteiro da rotina ZwCommitTransaction .

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

ZwCommitTransaction

ZwCreateTransaction

ZwOpenTransaction