Freigeben über

HrDispatchNotifications

  • Artikel

Gilt für: Outlook 2013 | Outlook 2016

Erzwingt die Verteilung aller Benachrichtigungen in der Warteschlange.

Eigenschaft Wert
Headerdatei
 Mapiutil.h
Implementiert von:
 MAPI
Aufgerufen von:
 Clientanwendungen und Dienstanbieter
 
HRESULT HrDispatchNotifications(
  ULONG ulFlags
);

Parameter

ulFlags

[in] Reserviert. NULL muss sein.

Rückgabewert

S_OK

Alle Benachrichtigungen in der Warteschlange wurden verteilt.

MAPI_E_USER_CANCEL

WM_QUIT, WM_QUERYENDSESSION oder WM_ENDSESSION wurden empfangen.

MAPI_E_NOT_INITIALIZED

MAPI wurde nicht initialisiert.

Hinweise

Die HrDispatchNotifications-Funktion bewirkt, dass MAPI alle Benachrichtigungen sendet, die sich derzeit in der MAPI-Benachrichtigungs-Engine in der Warteschlange befinden, ohne auf eine Nachrichtenverteilung zu warten. Dies kann sich positiv auf die Speicherauslastung auswirken. Weitere Informationen finden Sie unter Erzwingen einer Benachrichtigung.

Hinweise für Aufrufer

Einige Anwendungen warten mithilfe der Funktionen Windows PeekMessage und DispatchMessage in einer Timeoutschleife auf eine Benachrichtigung. Auf allen außer den schnellsten Plattformen können solche Anwendungen eine schlechte Leistung oder sogar eine Blockierung von Benachrichtigungen aufweisen. Die Verwendung von HrDispatchNotifications reduziert nicht nur den Code, sondern verbessert auch die Leistung.