NOTIFICATION
適用対象: 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構造体が含まれています。
info
特定の種類のイベントの影響を受けるデータを記述する通知構造の和集合。 情報メンバーに含まれる構造体は、ulEventType メンバーの値によって異なります。
注釈
登録されたアドバイズ シンクの IMAPIAdviseSink::OnNotify メソッドを呼び出すたびに、1 つ以上の NOTIFICATION 構造体が入力パラメーターとして渡されます。 NOTIFICATION 構造体には、発生した特定のイベントに関する情報が含まれており、影響を受けるオブジェクトを記述します。
通知を受け取るクライアントまたはサービス プロバイダーが構造体を使用してイベントを処理する前に、ulEventType メンバーに示されているようにイベントの種類をチェックする必要があります。 たとえば、次に示すコード サンプルは、新しいメッセージの到着をチェックし、この種のイベントを検出すると、メッセージのメッセージ クラスを出力します。
if (pNotif -> ulEventType == fnevNewMail)
{
printf("%s\n", pNotif -> newmail.lpszMessageClass)
}
通知の詳細については、次の表で説明するトピックを参照してください。
| トピック | 説明 |
|---|---|
| MAPI でのイベント通知 |
通知イベントと通知イベントの一般的な概要。 |
| 通知の処理 |
クライアントが通知を処理する方法について説明します。 |
| イベント通知のサポート |
サービス プロバイダーが IMAPISupport メソッドを使用して通知を生成する方法について説明します。 |