Función TmRecoverEnlistment (wdm.h)

Artículo
03/08/2023

La rutina TmRecoverEnlistment inicia una operación de recuperación para la transacción asociada a una inscripción especificada.

Sintaxis

NTSTATUS TmRecoverEnlistment(
  [in] PKENLISTMENT Enlistment,
  [in] PVOID        EnlistmentKey
);

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] EnlistmentKey

Puntero al valor de clave de inscripción que el administrador de recursos especificó anteriormente como parámetro EnlistmentKey en ZwCreateEnlistment o TmCreateEnlistment. Este parámetro es opcional y puede ser NULL si el administrador de recursos no proporcionó una clave de inscripción cuando llamó a ZwCreateEnlistment o TmCreateEnlistment.

Valor devuelto

TmRecoverEnlistment 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	Un identificador de objeto no es válido.
STATUS_TRANSACTION_REQUEST_NOT_VALID	La transacción o su inscripción no están en el estado correcto.
STATUS_PENDING	KTM ha agregado una notificación de confirmación, reversión o duda a la cola de notificaciones del administrador de recursos y el administrador de recursos no usa una rutina de devolución de llamada ResourceManagerNotification .

La rutina podría devolver otros valores NTSTATUS.

Comentarios

La rutina TmRecoverEnlistment es una versión basada en puntero de la rutina ZwRecoverEnlistment .

Para obtener información sobre cuándo usar rutinas TmXxx de KTM en lugar de rutinas ZwXxx , vea Using TmXxx Routines.

Para obtener más información sobre las operaciones de recuperación, consulte Control de operaciones de recuperación.

Requisitos

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