Función TmRollbackEnlistment (wdm.h)

Artículo
02/27/2024

La rutina TmRollbackEnlistment revierte una inscripción especificada.

Sintaxis

NTSTATUS TmRollbackEnlistment(
  [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 de objeto que proporciona una llamada anterior a ZwCreateEnlistment, TmCreateEnlistment o ZwOpenEnlistment .

[in] TmVirtualClock

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

Valor devuelto

TmRollbackEnlistment 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_REQUEST_NOT_VALID	No se puede revertir la inscripción.

La rutina podría devolver otros valores NTSTATUS.

Comentarios

La rutina TmRollbackEnlistment es una versión basada en punteros de la rutina ZwRollbackEnlistment .

Para obtener información sobre cuándo usar rutinas TmXxx de KTM en lugar de rutinas ZwXxx , vea Using TmXxx 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