Función NtRecoverTransactionManager (wdm.h)
El ZwRecoverTransactionManager rutina reconstruye el estado del objeto del administrador de transacciones (incluidas todas las transacciones, inscritos y administradores de recursos) 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, no se pueden recuperar sus transacciones. |
|
El objeto del administrador de transacciones no está en un estado que permita la recuperación. |
La rutina puede devolver otros valores NTSTATUS de .
Observaciones
El ZwRecoverTransactionManager rutina intenta reconstruir el estado del objeto del administrador de transacciones, incluidas todas las transacciones, las inscripciones y los administradores de recursos, desde 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 recuperar hasta un momento virtual específico, use la rutina de 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 Servicios del sistema nativo de Windows.
En el caso de las llamadas desde controladores en modo kernel, las NtXxx y Zwversiones de Xxx de una rutina de Servicios del sistema nativo de Windows pueden comportarse 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 de NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores del sistema operativo. |
| de la plataforma de destino de | Universal |
| encabezado de | wdm.h (include Wdm.h, Ntifs.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | PASSIVE_LEVEL |
| reglas de cumplimiento de DDI | HwStorPortProhibitedDIs, PowerIrpDDis |
Consulte también
usar versiones Nt y Zw de las rutinas de servicios del sistema nativo