Compartir a través de


Función NtSinglePhaseReject (wdm.h)

La rutina ZwSinglePhaseReject informa a KTM de que el administrador de recursos que realiza la llamada no admitirá operaciones de confirmación de fase única para una inscripción especificada.

Sintaxis

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

Parámetros

[in] EnlistmentHandle

Identificador de un objeto de inscripción obtenido por una llamada anterior a ZwCreateEnlistment o ZwOpenEnlistment. El identificador debe tener ENLISTMENT_SUBORDINATE_RIGHTS acceso al objeto .

[in, optional] TmVirtualClock

Puntero a un valor de reloj virtual. Este parámetro es opcional y puede ser NULL.

Valor devuelto

ZwSinglePhaseReject devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta rutina podría devolver uno de los siguientes valores:

Código devuelto Descripción
STATUS_OBJECT_TYPE_MISMATCH
El identificador especificado no es un identificador para un objeto de inscripción.
STATUS_INVALID_HANDLE
El identificador de objeto no es válido.
STATUS_TRANSACTION_NOT_REQUESTED
La transacción o su inscripción no está en el estado correcto.
STATUS_ACCESS_DENIED
El autor de la llamada no tiene el acceso adecuado al objeto de inscripción.
 

La rutina podría devolver otros valores NTSTATUS.

Comentarios

Un administrador de recursos puede llamar a ZwSinglePhaseReject cuando recibe una notificación de TRANSACTION_NOTIFY_SINGLE_PHASE_COMMIT.

Para obtener más información sobre ZwSinglePhaseReject, vea Control de las operaciones de confirmación.

NtSinglePhaseReject y ZwSinglePhaseReject son dos versiones de la misma rutina de Servicios del sistema nativo de Windows. La rutina NtSinglePhaseReject del kernel de Windows no es accesible directamente para los controladores en modo kernel. Sin embargo, los controladores en modo kernel pueden acceder a esta rutina indirectamente llamando a la rutina ZwSinglePhaseReject .

En el caso de las llamadas desde controladores en modo kernel, las versiones NtXxx y ZwXxx de una rutina de Servicios del sistema nativo de Windows se pueden comportar de forma diferente en la forma en que controlan e interpretan los parámetros de entrada. Para obtener más información sobre la relación entre las versiones NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores del sistema operativo.
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Reglas de cumplimiento de DDI HwStorPortProhibitedDIs, PowerIrpDDis

Consulte también

TmSinglePhaseReject

Uso de las versiones Nt y Zw de las rutinas nativas de Servicios del sistema

ZwCreateEnlistment

ZwOpenEnlistment