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 會將 lpUlFlags 參數設定為從 IMAPISupport::Notify 傳回時NOTIFY_CANCELED。

以下是同步回檔函式可執行之功能的限制:

  • 它無法產生另一個同步通知。

  • 它無法顯示使用者介面。

另請參閱

IMAPIAdviseSink::OnNotify