Função NtCommitTransaction (wdm.h)

Artigo
07/02/2025

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

Sintaxe

C++

__kernel_entry NTSYSCALLAPI NTSTATUS NtCommitTransaction(
  [in] HANDLE  TransactionHandle,
  [in] BOOLEAN Wait
);

Parâmetros

[in] TransactionHandle

Um identificador para um objeto de transação . Seu componente recebe esse identificador de ZwCreateTransaction ou ZwOpenTransaction. O identificador deve ter acesso TRANSACTION_COMMIT ao objeto.

[in] Wait

Um valor booliano que o chamador define como verdadeiro para operação síncrona ou FALSE para operação assíncrona. Se esse parâmetro for VERDADEIRO, a chamada retornará após a conclusão da operação de confirmação.

Valor de retorno

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

Código de retorno	Descrição
STATUS_OBJECT_TYPE_MISMATCH	O identificador especificado para o parâmetro TransactionHandle não é um identificador para um objeto de transação.
STATUS_INVALID_HANDLE	O identificador de objeto de transação especificado é inválido.
STATUS_ACCESS_DENIED	O chamador não tem acesso apropriado ao objeto de transaçã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 dessa transação já foi iniciada.
STATUS_PENDING	As notificações de confirmação foram enfileiradas em gerenciadores de recursos e o chamador especificado FALSE para o parâmetro Wait.

A rotina pode retornar outros valores NTSTATUS .

Observações

Para obter mais informações sobre como os clientes de transação devem usar a rotina de ZwCommitTransaction, consulte Criando um cliente transacional.

Para obter mais informações sobre operações de confirmação, consulte Tratando operações de confirmação.

Para chamadas de drivers no modo kernel, as versões NtXxx e Zwxxx versões de uma rotina dos Serviços de Sistema Nativo do Windows podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e ZwXxx de uma rotina, consulte Usando versões Nt e Zw das rotinas de serviços do sistema nativo.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows Vista e versões posteriores do Windows.
da Plataforma de Destino	Universal
cabeçalho	wdm.h (include Wdm.h, Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
regras de conformidade de DDI	HwStorPortProhibitedDIs, PowerIrpDDis

Consulte também

TmCommitTransaction

usando versões Nt e Zw das rotinas de serviços do sistema nativo

ZwCreateTransaction

ZwOpenTransaction

Partilhar via