Compartir a través de


Función GetNotificationResourceManager (ktmw32.h)

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

Consulte también

CreateEnlistment

GetNotificationResourceManagerAsync

Funciones del Administrador de transacciones de kernel

NOTIFICATION_MASK

SetResourceManagerCompletionPort

TRANSACTION_NOTIFICATION

TRANSACTION_NOTIFICATION_RECOVERY_ARGUMENT