Função TmCommitTransaction (wdm.h)
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 |
|---|---|
|
O chamador não pode confirmar a transação porque existe um gerenciador de transações superior . |
|
A transação não pode ser confirmada porque foi revertida. |
|
A transação já está confirmada. |
|
A operação de confirmação para essa transação já foi iniciada. |
|
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 |