HrDispatchNotifications

適用対象: Outlook 2013 | Outlook 2016

キューに登録されたすべての通知のディスパッチを強制します。

プロパティ
ヘッダー ファイル:
Mapiutil.h
実装元:
MAPI
呼び出し元:
クライアント アプリケーションとサービス プロバイダー
HRESULT HrDispatchNotifications(
  ULONG ulFlags
);

パラメーター

ulFlags

[����]�\�񂳂�Ă��܂��B0 �ɂ���K�v������܂��B

戻り値

S_OK

キューに登録されたすべての通知がディスパッチされました。

MAPI_E_USER_CANCEL

WM_QUIT、WM_QUERYENDSESSION、またはWM_ENDSESSIONが受信されました。

MAPI_E_NOT_INITIALIZED

MAPI が初期化されませんでした。

注釈

HrDispatchNotifications 関数を使用すると、MAPI は、メッセージのディスパッチを待たずに、MAPI 通知エンジンで現在キューに登録されているすべての通知をディスパッチします。 これは、メモリ使用率に有益な影響を与える可能性があります。 詳細については、「 通知の強制」を参照してください。

呼び出し側への注意

一部のアプリケーションでは、Windows PeekMessage 関数と DispatchMessage 関数を使用して、タイムアウト ループで通知メッセージを待機します。 最速のプラットフォーム以外では、このようなアプリケーションではパフォーマンスが低下したり、通知がブロックされたりする可能性があります。 HrDispatchNotifications を使用すると、コードが減るだけでなく、パフォーマンスが向上します。