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 Resource Manager 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
STATUS_OBJECT_TYPE_MISMATCH
El identificador especificado no es un identificador para un objeto de Resource Manager.
STATUS_INVALID_HANDLE
Un identificador de objeto no es válido.
STATUS_TRANSACTIONMANAGER_NOT_ONLINE
El administrador de transacciones asociado al administrador de recursos especificado no está disponible.
STATUS_ACCESS_DENIED
El autor de la llamada no tiene el acceso adecuado al objeto de Resource Manager.
 

La rutina puede devolver otros valores NTSTATUS de .

Observaciones

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 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

Consulte también

TmRecoverResourceManager

usar versiones Nt y Zw de las rutinas de servicios del sistema nativo

ZwCreateResourceManager

ZwOpenResourceManager

ZwQueryInformationResourceManager

ZwSetInformationResourceManager