Função TmSinglePhaseReject (wdm.h)

Artigo
02/27/2024

A rotina TmSinglePhaseReject informa ao KTM que o gerenciador de recursos de chamada não dará suporte a uma operação de confirmação de fase única para uma inscrição especificada.

Sintaxe

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

Parâmetros

[in] Enlistment

Um ponteiro para um objeto de inscrição. Seu componente pode receber esse ponteiro como entrada para uma rotina de retorno de chamada ResourceManagerNotification . Como alternativa, seu componente pode chamar ObReferenceObjectByHandle e fornecer o identificador de objeto fornecido por uma chamada anterior para ZwCreateEnlistment, TmCreateEnlistment ou ZwOpenEnlistment .

[in] TmVirtualClock

Um ponteiro para um valor de relógio virtual. Esse parâmetro é opcional e pode ser NULL.

Retornar valor

TmSinglePhaseReject retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa rotina pode retornar o seguinte valor:

Código de retorno	Descrição
STATUS_TRANSACTION_NOT_REQUESTED	A transação ou sua inscrição não está no estado correto.

A rotina pode retornar outros valores NTSTATUS.

Comentários

A rotina TmSinglePhaseReject é uma versão baseada em ponteiro da rotina ZwSinglePhaseReject .

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