Función TmSinglePhaseReject (wdm.h)

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

Sintaxis

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

Parámetros

[in] Enlistment

Puntero a un objeto de inscripción. El componente puede recibir este puntero como entrada en una rutina de devolución de llamada ResourceManagerNotification . Como alternativa, el componente puede llamar a ObReferenceObjectByHandle y proporcionar el identificador del objeto que proporcionó una llamada anterior a ZwCreateEnlistment, TmCreateEnlistment o ZwOpenEnlistment proporcionada.

[in] TmVirtualClock

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

Valor devuelto

TmSinglePhaseReject devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta rutina podría devolver el siguiente valor:

Código devuelto Descripción
STATUS_TRANSACTION_NOT_REQUESTED
La transacción o su inscripción no está en el estado correcto.
 

La rutina podría devolver otros valores NTSTATUS.

Comentarios

La rutina TmSinglePhaseReject es una versión basada en puntero de la rutina ZwSinglePhaseReject .

Para obtener información sobre cuándo usar las rutinas TmXxx de KTM en lugar de las rutinas ZwXxx , consulte Uso de rutinas TmXxx.

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

Consulte también

ObReferenceObjectByHandle

ResourceManagerNotification

TmCreateEnlistment

ZwCreateEnlistment

ZwOpenEnlistment

ZwSinglePhaseReject