通知NOTIFICATION

適用されます: OutlookApplies to: Outlook

イベントが発生したことと、イベントによって影響のあるデータに関する情報が含まれています。Contains information about an event that has occurred and the data that has been affected by the event.

ヘッダー ファイル:Header file:
Mapidefs.hMapidefs.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;

メンバーMembers

ulEventTypeulEventType

発生した通知イベントの種類です。Type of notification event that occurred. UlEventTypeメンバーの値は、情報の共用体に含まれる構造体に対応します。The value of the ulEventType member corresponds to the structure that is included in the info union. UlEventTypeメンバーは、次の値のいずれかに設定できます。The ulEventType member can be set to one of the following values:

fnevCriticalErrorfnevCriticalError

セッションの実行中のシャット ダウンなど、グローバル エラーが発生しました。A global error has occurred, such as a session shut down in progress. 情報のメンバーには、 ERROR_NOTIFICATION構造体が含まれています。The info member contains an ERROR_NOTIFICATION structure.

fnevExtendedfnevExtended

特定のサービス プロバイダーによって定義されている内部のイベントが発生しました。An internal event defined by a particular service provider has occurred. 情報のメンバーには、 EXTENDED_NOTIFICATION構造体が含まれています。The info member contains an EXTENDED_NOTIFICATION structure.

fnevNewMailfnevNewMail

メッセージが配信されましたが、該当するメッセージ クラスのフォルダーが表示され、処理されるを待っています。A message has been delivered to the appropriate receive folder for the message class and is waiting to be processed. 情報のメンバーには、 NEWMAIL_NOTIFICATION構造体が含まれています。The info member contains an NEWMAIL_NOTIFICATION structure.

fnevObjectCopiedfnevObjectCopied

MAPI オブジェクトがコピーされました。A MAPI object has been copied. 情報のメンバーには、 OBJECT_NOTIFICATION構造体が含まれています。The info member contains an OBJECT_NOTIFICATION structure.

fnevObjectCreatedfnevObjectCreated

MAPI オブジェクトが用意されています。A MAPI object has been created. 情報のメンバーには、 OBJECT_NOTIFICATION構造体が含まれています。The info member contains an OBJECT_NOTIFICATION structure.

fnevObjectDeletedfnevObjectDeleted

MAPI オブジェクトが削除されました。A MAPI object has been deleted. 情報のメンバーには、 OBJECT_NOTIFICATION構造体が含まれています。The info member contains an OBJECT_NOTIFICATION structure.

fnevObjectModifiedfnevObjectModified

MAPI オブジェクトが変更されました。A MAPI object has changed. 情報のメンバーには、 OBJECT_NOTIFICATION構造体が含まれています。The info member contains an OBJECT_NOTIFICATION structure.

fnevObjectMovedfnevObjectMoved

メッセージ ストアやアドレス帳オブジェクトが移動されました。A message store or address book object has been moved. 情報のメンバーには、 OBJECT_NOTIFICATION構造体が含まれています。The info member contains an OBJECT_NOTIFICATION structure.

fnevSearchCompletefnevSearchComplete

検索操作が完了し、結果が保存されます。A search operation has finished and the results are available. 情報のメンバーには、 OBJECT_NOTIFICATION構造体が含まれています。The info member contains an OBJECT_NOTIFICATION structure.

fnevTableModifiedfnevTableModified

テーブル内の情報が変更されました。Information in a table has changed. 情報のメンバーには、 TABLE_NOTIFICATION構造体が含まれています。The info member contains an TABLE_NOTIFICATION structure.

情報info

イベントの特定の種類の影響を受けるデータを記述する通知の構造体の共用体です。Union of notification structures describing the affected data for a particular type of event. 情報のメンバーに含まれている構造体は、 ulEventTypeメンバーの値によって異なります。The structure included in the info member depends on the value of the ulEventType member.

備考Remarks

1 つまたは複数の通知の構造体は、登録されているアドバイズ シンクのIMAPIAdviseSink::OnNotifyメソッドを呼び出すたびに、入力パラメーターとして渡されます。One or more NOTIFICATION structures are passed as input parameters with every call to a registered advise sink's IMAPIAdviseSink::OnNotify method. 通知の構造体は、発生し、影響を受けるオブジェクトについて説明する特定のイベントに関する情報を格納します。The NOTIFICATION structures contain information about the particular events that have occurred and describe the affected objects.

クライアントまたはサービス プロバイダーが通知の受信の場合は、イベントを処理する構造を使用できます、前に、イベントの種類を確認して、 ulEventTypeメンバーに示されている必要があります。Before clients or service providers receiving a notification can use the structure to process the event, they must check the event type as indicated in the ulEventType member. たとえば、ここでの新しいメッセージと、この種類のイベントを検出すると、到着の確認が表示されているコード サンプルは、メッセージのメッセージ クラスを出力します。For example, the code sample that is shown here checks for the arrival of a new message and upon detecting an event of this kind, prints out the message class of the message.

if (pNotif -> ulEventType == fnevNewMail)
{
printf("%s\n", pNotif -> newmail.lpszMessageClass)
}

通知の詳細については、次の表に記載されているトピックを参照してください。For more information about notification, see the topics described in the following table.

トピックTopic 説明Description
MAPI でのイベントの通知Event Notification in MAPI
通知と通知のイベントの概要です。General overview of notification and notification events.
通知の処理Handling Notifications
クライアントが通知を処理する方法について説明します。Discussion of how clients should handle notifications.
イベント通知をサポートしています。Supporting Event Notification
サービス プロバイダーが、 IMAPISupportメソッドを使用して、通知を生成する方法について説明します。Discussion of how service providers can use the IMAPISupport method to generate notifications.

関連項目See also