Función ZwRecoverTransactionManager (wdm.h)
La rutina ZwRecoverTransactionManager reconstruye 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.
Sintaxis
NTSYSCALLAPI NTSTATUS ZwRecoverTransactionManager(
[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 termina al final de la secuencia.
Para recuperar hasta un momento 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 Windows Native System Services 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 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(storport), PowerIrpDDis(wdm) |
Consulte también
Uso de las versiones Nt y Zw de las rutinas nativas de System Services