通过


HrDispatchNotifications

适用于:Outlook 2013 | Outlook 2016

强制调度所有排队通知。

属性
标头文件:
Mapiutil.h
实现者:
MAPI
调用者:
客户端应用程序和服务提供商
HRESULT HrDispatchNotifications(
  ULONG ulFlags
);

参数

ulFlags

[in]保留;必须为零。

返回值

S_OK

已调度所有排队通知。

MAPI_E_USER_CANCEL

已收到WM_QUIT、WM_QUERYENDSESSION或WM_ENDSESSION。

MAPI_E_NOT_INITIALIZED

MAPI 未初始化。

备注

HrDispatchNotifications 函数会导致 MAPI 调度当前在 MAPI 通知引擎中排队的所有通知,而无需等待消息调度。 这会对内存利用率产生有益的影响。 有关详细信息,请参阅 强制通知

给调用方的说明

某些应用程序使用 Windows PeekMessageDispatchMessage 函数在超时循环中等待通知消息。 在除最快的平台上,此类应用程序可能会遇到性能不佳甚至通知阻塞。 使用 HrDispatchNotifications 不仅可以减少代码,还能提高性能。