Función GetNotificationResourceManager (ktmw32.h)

Artículo
03/13/2024

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

Sintaxis

BOOL GetNotificationResourceManager(
  [in]            HANDLE                    ResourceManagerHandle,
  [out]           PTRANSACTION_NOTIFICATION TransactionNotification,
  [in]            ULONG                     NotificationLength,
  [in, optional]  DWORD                     dwMilliseconds,
  [out, optional] PULONG                    ReturnLength
);

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

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

[in, optional] dwMilliseconds

El tiempo, en milisegundos, para el que la aplicación que realiza la llamada está bloqueando mientras espera a que la notificación esté disponible. Si no hay notificaciones disponibles cuando expira el tiempo de espera, se devuelve ERROR_TIMEOUT .

[out, optional] ReturnLength

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

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

Requisitos

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