Função ZwSinglePhaseReject (wdm.h)

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

Sintaxe

NTSYSCALLAPI NTSTATUS ZwSinglePhaseReject(
  [in]           HANDLE         EnlistmentHandle,
  [in, optional] PLARGE_INTEGER TmVirtualClock
);

Parâmetros

[in] EnlistmentHandle

Um identificador para um objeto de inscrição que foi obtido por uma chamada anterior para ZwCreateEnlistment ou ZwOpenEnlistment. O identificador deve ter ENLISTMENT_SUBORDINATE_RIGHTS acesso ao objeto .

[in, optional] TmVirtualClock

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

Retornar valor

ZwSinglePhaseReject 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_OBJECT_TYPE_MISMATCH	O identificador especificado não é um identificador para um objeto de inscrição.
STATUS_INVALID_HANDLE	O identificador do objeto é inválido.
STATUS_TRANSACTION_NOT_REQUESTED	A transação ou sua inscrição não está no estado correto.
STATUS_ACCESS_DENIED	O chamador não tem acesso apropriado ao objeto de inscrição.

 

A rotina pode retornar outros valores NTSTATUS.

Comentários

Um gerenciador de recursos pode chamar ZwSinglePhaseReject quando recebe uma notificação de TRANSACTION_NOTIFY_SINGLE_PHASE_COMMIT.

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

NtSinglePhaseReject e ZwSinglePhaseReject são duas versões da mesma rotina do Windows Native System Services. A rotina NtSinglePhaseReject no kernel do Windows não é diretamente acessível para drivers no modo kernel. No entanto, os drivers de modo kernel podem acessar essa rotina indiretamente chamando a rotina ZwSinglePhaseReject .

Para chamadas de drivers de modo kernel, as versões NtXxx e ZwXxx de uma rotina do Windows Native System Services 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 Using Nt and Zw Versions of the Native System Services Routines.

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
Regras de conformidade da DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Confira também

TmSinglePhaseReject

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

ZwCreateEnlistment

ZwOpenEnlistment