Función NtRecoverTransactionManager (wdm.h)
La rutina ZwRecoverTransactionManager reconstruye el estado del objeto del administrador de transacciones (incluidas todas las transacciones, las inscripciones y los administradores de recursos) a partir de la información de recuperación que se encuentra en el flujo de registro.
Sintaxis
__kernel_entry NTSYSCALLAPI NTSTATUS NtRecoverTransactionManager(
[in] HANDLE TransactionManagerHandle
);
Parámetros
[in] TransactionManagerHandle
Identificador de un objeto de administrador de transacciones obtenido por una llamada anterior a ZwCreateTransactionManager o ZwOpenTransactionManager. El identificador debe tener TRANSACTIONMANAGER_RECOVER acceso al objeto .
Valor devuelto
ZwRecoverTransactionManager 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 |
|---|---|
|
El identificador especificado no es un identificador para un objeto de administrador de transacciones. |
|
Un identificador de objeto no es válido. |
|
El autor de la llamada no tiene el acceso adecuado al objeto del administrador de transacciones. |
|
El objeto del administrador de transacciones es volátil y, por lo tanto, sus transacciones no se pueden recuperar. |
|
El objeto del administrador de transacciones no está en un estado que permita la recuperación. |
La rutina podría devolver otros valores NTSTATUS.
Comentarios
La rutina ZwRecoverTransactionManager intenta reconstruir el estado del objeto del administrador de transacciones, incluidas todas las transacciones, los inscritos y los administradores de recursos, a partir de la información de recuperación que se encuentra en el flujo de registro del objeto, comenzando en el último área de reinicio que KTM creó y terminó al final de la secuencia.
Para recuperarse hasta un tiempo virtual específico, use la rutina ZwRollforwardTransactionManager en lugar de ZwRecoverTransactionManager.
El componente tpS debe llamar a ZwRecoverTransactionManager después de llamar a ZwCreateTransactionManager o ZwOpenTransactionManager.
Para obtener más información sobre las operaciones de recuperación, consulte Control de operaciones de recuperación.
NtRecoverTransactionManager y ZwRecoverTransactionManager son dos versiones de la misma rutina de Windows Native System Services.
En el caso de las llamadas desde controladores en modo kernel, las versiones NtXxx y ZwXxx de una rutina de Servicios del sistema nativo de Windows se pueden comportar de forma diferente en la forma en que controlan e interpretan los parámetros de entrada. Para obtener más información sobre la relación entre las versiones NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services 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, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | HwStorPortProhibitedDIs, PowerIrpDDis |
Consulte también
Uso de las versiones Nt y Zw de las rutinas nativas de Servicios del sistema