Función TmRequestOutcomeEnlistment (wdm.h)
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 |
|---|---|
|
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 |