Función TmRequestOutcomeEnlistment (wdm.h)

Artículo
02/27/2024

La rutina TmRequestOutcomeEnlistment pide a KTM que intente proporcionar un resultado inmediato (confirmación o reversión) para la transacción asociada a una inscripción especificada.

Sintaxis

NTSTATUS TmRequestOutcomeEnlistment(
  [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

TmRequestOutcomeEnlistment 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	La inscripción especificada es una inscripción superior.

La rutina podría devolver otros valores NTSTATUS.

Comentarios

La rutina TmRequestOutcomeEnlistment pide a KTM que intente proporcionar un resultado inmediato (resultado) para la transacción. Un administrador de recursos puede llamar a TmRequestOutcomeEnlistment después de llamar a TmPrepareComplete o ZwPrepareComplete, si más adelante detecta que no puede esperar un resultado porque, por ejemplo, se ha producido una eliminación sorpresa del disco. KTM podría forzar una reversión si todos los administradores de recursos no han terminado sus operaciones de preparación.

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 TmCreateEnlistment, vea Creating a Resource Manager.

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