通知
適用於:Outlook 2013 |Outlook 2016
包含已發生之事件的相關信息,以及受事件影響的數據。
屬性 | 值 |
---|---|
標頭檔: |
Mapidefs.h |
typedef struct
{
ULONG ulEventType;
union
{
ERROR_NOTIFICATION err;
NEWMAIL_NOTIFICATION newmail;
OBJECT_NOTIFICATION obj;
TABLE_NOTIFICATION tab;
EXTENDED_NOTIFICATION ext;
STATUS_OBJECT_NOTIFICATION statobj;
} info;
} NOTIFICATION, FAR *LPNOTIFICATION;
成員
ulEventType
發生的通知事件類型。 ulEventType 成員的值會對應至資訊聯集內含的結構。 ulEventType 成員可以設定為下列其中一個值:
fnevCriticalError
發生全域錯誤,例如會話正在關閉。 信息成員包含ERROR_NOTIFICATION結構。
fnevExtended
發生由特定服務提供者定義的內部事件。 信息成員包含EXTENDED_NOTIFICATION結構。
fnevNewMail
訊息已傳遞至訊息類別的適當接收資料夾,並正在等候處理。 信息成員包含NEWMAIL_NOTIFICATION結構。
fnevObjectCopied
已複製MAPI物件。 信息成員包含OBJECT_NOTIFICATION結構。
fnevObjectCreated
已建立MAPI物件。 信息成員包含OBJECT_NOTIFICATION結構。
fnevObjectDeleted
MAPI 物件已刪除。 信息成員包含OBJECT_NOTIFICATION結構。
fnevObjectModified
MAPI 對象已變更。 信息成員包含OBJECT_NOTIFICATION結構。
fnevObjectMoved
郵件存放區或通訊錄物件已移動。 信息成員包含OBJECT_NOTIFICATION結構。
fnevSearchComplete
搜尋作業已完成,且結果可供使用。 信息成員包含OBJECT_NOTIFICATION結構。
fnevTableModified
數據表中的資訊已變更。 信息成員包含TABLE_NOTIFICATION結構。
資訊
通知結構的聯集,描述特定事件類型的受影響數據。 信息成員中包含的結構取決於ulEventType成員的值。
註解
每次呼叫已註冊的建議接收的 IMAPIAdviseSink::OnNotify 方法時,都會傳遞一或多個 NOTIFICATION 結構作為輸入參數。 NOTIFICATION 結構包含已發生之特定事件的相關信息,並描述受影響的物件。
接收通知的用戶端或服務提供者必須先檢查事件類型,如 ulEventType 成員所示,才能使用結構來處理事件。 例如,此處顯示的程式代碼範例會檢查新訊息的送達,以及偵測到此類事件時,列印出訊息的訊息類別。
if (pNotif -> ulEventType == fnevNewMail)
{
printf("%s\n", pNotif -> newmail.lpszMessageClass)
}
如需通知的詳細資訊,請參閱下表所述的主題。
主題 | 描述 |
---|---|
MAPI 中的事件通知 |
通知和通知事件的一般概觀。 |
處理通知 |
討論用戶端應如何處理通知。 |
支援事件通知 |
討論服務提供者如何使用 IMAPISupport 方法來產生通知。 |