Función NtRecoverResourceManager (wdm.h)
La rutina ZwRecoverResourceManager intenta recuperar la transacción asociada a cada inscripción de un objeto de Resource Manager especificado.
Sintaxis
__kernel_entry NTSYSCALLAPI NTSTATUS NtRecoverResourceManager(
[in] HANDLE ResourceManagerHandle
);
Parámetros
[in] ResourceManagerHandle
Identificador de un objeto de administrador de recursos obtenido por una llamada anterior a ZwCreateResourceManager o ZwOpenResourceManager. El identificador debe tener RESOURCEMANAGER_RECOVER acceso al objeto .
Valor devuelto
ZwRecoverResourceManager 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 Resource Manager. |
|
Un identificador de objeto no es válido. |
|
El administrador de transacciones asociado al administrador de recursos especificado no está disponible. |
|
El autor de la llamada no tiene el acceso adecuado al objeto de Resource Manager. |
La rutina podría devolver otros valores NTSTATUS.
Comentarios
Cuando un administrador de recursos llama a ZwRecoverResourceManager, KTM envía una notificación TRANSACTION_NOTIFY_RECOVER al administrador de recursos para cada una de las inscripciones del administrador de recursos. (Si la inscripción es una inscripción superior, KTM envía TRANSACTION_NOTIFY_RECOVER_QUERY en lugar de TRANSACTION_NOTIFY_RECOVER).
La notificación final que KTM envía al administrador de recursos es TRANSACTION_NOTIFY_LAST_RECOVER.
Para obtener más información sobre ZwRecoverResourceManager, consulte Control de operaciones de recuperación.
NtRecoverResourceManager y ZwRecoverResourceManager 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 |
Consulte también
Uso de las versiones Nt y Zw de las rutinas nativas de System Services