HrDispatchNotifications

S’applique à : Outlook 2013 | Outlook 2016

Force la distribution de toutes les notifications en file d’attente.

Propriété	Valeur
Fichier d’en-tête :	Mapiutil.h
Implémenté par :	MAPI
Appelé par :	Applications clientes et fournisseurs de services

HRESULT HrDispatchNotifications(
  ULONG ulFlags
);

Paramètres

ulFlags

[in] R�serv� ; doit �tre �gal � z�ro.

Valeur renvoyée

S_OK

Toutes les notifications en file d’attente ont été distribuées.

MAPI_E_USER_CANCEL

WM_QUIT, WM_QUERYENDSESSION ou WM_ENDSESSION ont été reçus.

MAPI_E_NOT_INITIALIZED

MAPI n’a pas été initialisé.

Remarques

La fonction HrDispatchNotifications permet à MAPI de distribuer toutes les notifications actuellement mises en file d’attente dans le moteur de notification MAPI sans attendre une distribution de message. Cela peut avoir un effet bénéfique sur l’utilisation de la mémoire. Pour plus d’informations, consultez Forcer une notification.

Remarques pour les appelants

Certaines applications attendent un message de notification dans une boucle de délai d’expiration à l’aide des fonctions Windows PeekMessage et DispatchMessage . Sur toutes les plateformes sauf les plus rapides, ces applications peuvent rencontrer des performances médiocres ou même un blocage des notifications. L’utilisation de HrDispatchNotifications réduit non seulement le code, mais améliore également les performances.