HrDispatchNotifications

Hace referencia a: Outlook 2013 | Outlook 2016

Fuerza el envío de todas las notificaciones en cola.

Propiedad	Valor
Archivo de encabezado:	Mapiutil.h
Implementado por:	MAPI
Llamado por:	Aplicaciones cliente y proveedores de servicios

HRESULT HrDispatchNotifications(
  ULONG ulFlags
);

Parameters

ulFlags

[entrada] Reservado; debe ser cero.

Valor devuelto

S_OK

Se han enviado todas las notificaciones en cola.

MAPI_E_USER_CANCEL

se recibió WM_QUIT, WM_QUERYENDSESSION o WM_ENDSESSION.

MAPI_E_NOT_INITIALIZED

MAPI no se ha inicializado.

Comentarios

La función HrDispatchNotifications hace que MAPI envíe todas las notificaciones que están actualmente en cola en el motor de notificaciones MAPI sin esperar a que se envíe un mensaje. Esto puede tener un efecto beneficioso en el uso de memoria. Para obtener más información, vea Forzar una notificación.

Notas para los llamadores

Algunas aplicaciones esperan un mensaje de notificación en un bucle de tiempo de espera mediante las funciones Windows PeekMessage y DispatchMessage . En todas las plataformas, excepto en las más rápidas, estas aplicaciones pueden experimentar un rendimiento deficiente o incluso un bloqueo de las notificaciones. El uso de HrDispatchNotifications no solo reduce el código, sino que mejora el rendimiento.