Función GetNotificationResourceManagerAsync (ktmw32.h)

Artículo
08/24/2023

Solicita y recibe una notificación asincrónica para un administrador de recursos (RM). El registro rm usa esta función para recibir notificaciones cuando cambia el estado de una transacción.

Sintaxis

BOOL GetNotificationResourceManagerAsync(
  [in]  HANDLE                    ResourceManagerHandle,
  [out] PTRANSACTION_NOTIFICATION TransactionNotification,
  [in]  ULONG                     TransactionNotificationLength,
  [out] PULONG                    ReturnLength,
  [in]  LPOVERLAPPED              lpOverlapped
);

Parámetros

[in] ResourceManagerHandle

Identificador del administrador de recursos.

[out] TransactionNotification

Puntero a una estructura de TRANSACTION_NOTIFICATION que recibe la primera notificación disponible.

[in] TransactionNotificationLength

Tamaño del búfer TransactionNotification , en bytes.

[out] ReturnLength

Puntero a una variable que recibe el tamaño real de la notificación recibida por el parámetro TransactionNotification .

[in] lpOverlapped

Puntero a una estructura SUPERPUESTA necesaria para la operación asincrónica.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero (0). Para obtener información ampliada de los errores, llame a la función GetLastError.

En la lista siguiente se identifican los posibles códigos de error:

Comentarios

Todos los administradores de recursos deben registrarse para recibir notificaciones de TRANSACTION_NOTIFY_PREPREPARE, TRANSACTION_NOTIFY_PREPARE y TRANSACTION_NOTIFY_COMMIT , incluso si posteriormente llaman a ReadOnlyEnlistment para marcar una inscripción como de solo lectura. Los administradores de recursos pueden admitir TRANSACTION_NOTIFY_SINGLE_PHASE_COMMIT, pero también deben admitir las notificaciones de preparación previa, preparación y confirmación de varias fases. Para obtener la lista de todas las notificaciones que pueden recibir los administradores de recursos, consulte TRANSACTION_NOTIFICATION.

Es posible que los administradores de recursos (RM) quieran llamar a esta función más de una vez para proporcionar varios búferes para que KTM los use al entregar notificaciones. El número de llamadas a esta función depende de la carga que lleva el RM.

Se debe llamar a esta función después de llamar a la función SetResourceManagerCompletionPort .

Requisitos


Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	ktmw32.h
Library	KtmW32.lib
Archivo DLL	KtmW32.dll