NOTIFCALLBACK

  • [アーティクル]

適用対象: Outlook 2013 | Outlook 2016

MAPI がイベント通知を送信するために呼び出すコールバック関数を定義します。 このコールバック関数は、 HrAllocAdviseSink 関数を呼び出すことによって作成されたアドバイズ シンク オブジェクトにラップされている場合にのみ使用できます。

プロパティ 値
ヘッダー ファイル:
 Mapidefs.h
によって実装される定義された関数:
 クライアント アプリケーションとサービス プロバイダー
によって呼び出される定義済み関数:
 MAPI
 
ULONG (STDAPICALLTYPE NOTIFCALLBACK)(
  LPVOID lpvContext,
  ULONG cNotification,
  LPNOTIFICATION lpNotifications
);

パラメーター

lpvContext

[in]MAPI がそれを呼び出すときにコールバック関数に渡される任意の値へのポインター。 この値は、クライアント アプリケーションまたはサービス プロバイダーにとって重要なアドレスを表すことができます。 通常、C++ コードの場合、 lpvContext パラメーターは C++ オブジェクトへのポインターを表します。

cNotification

[in] lpNotifications パラメーターによって示される配列内のイベント通知の数。

lpNotifications

[out]この関数がイベント通知を含む NOTIFICATION 構造体の配列を書き込む場所へのポインター。

戻り値

NOTIFCALLBACK 関数プロトタイプの有効な戻り値のセットは、関数がクライアント アプリケーションまたはサービス プロバイダーによって実装されているかどうかによって異なります。 クライアントは常にS_OKを返す必要があります。 プロバイダーは、S_OKまたはCALLBACK_DISCONTINUEを返すことができます。

注釈

CALLBACK_DISCONTINUEは、同期コールバック関数に対してのみ有効な戻り値です。MAPI は、この通知のコールバックの処理をすぐに停止するよう要求します。 CALLBACK_DISCONTINUEが返されると、MAPI は、IMAPISupport::Notify から戻ったときに lpUlFlags パラメーターをNOTIFY_CANCELEDに設定します。

同期コールバック関数で実行できる操作に関する制限事項を次に示します。

  • 別の同期通知を生成することはできません。

  • ユーザー インターフェイスを表示できません。

関連項目

IMAPIAdviseSink::OnNotify