Compartir a través de

Función TmRecoverEnlistment (wdm.h)

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

Consulte también

ObReferenceObjectByHandle

ResourceManagerNotification

TRANSACTION_NOTIFICATION

TmCreateEnlistment

ZwCreateEnlistment

ZwGetNotificationResourceManager

ZwOpenEnlistment

ZwRecoverEnlistment

  • Last updated on