メッセージ ストア プロバイダーの通知を提供します。Providing Notifications for Message Store Providers

適用されます: OutlookApplies to: Outlook

通知は省略可能ですが、適切なメッセージ ストア プロバイダーの非常に重要な含まにはれています。While notifications are optional, they are a very important part of a good message store provider. クライアント アプリケーションと MAPI スプーラーは、メッセージ ストア プロバイダーからの通知メッセージを送信または受信側の受信メッセージを送信するときに、良好なパフォーマンスを取得するに依存します。Client applications and the MAPI spooler rely on notifications from the message store provider to get good performance when submitting outgoing messages or receiving incoming messages. クライアントと、MAPI スプーラーは、メッセージ ストア プロバイダーから通知を受信する前に機能できますが、変更せずにメッセージ ・ ストア内のユーザーに通知することはできません。Clients and the MAPI spooler can function without receiving notifications from the message store provider, but they will not be able to inform users of changes in the message store without them. 通常、ユーザーが、クライアントは、メッセージ ストアを次に開くまで、新しいメッセージが到着したことを確認することことを意味では、フォルダーが表示されます。Typically, this means that users will be unable to see that a new message has arrived until their client next opens the message store's receive folder.

クライアントは、 IMsgStore::Adviseメソッドを呼び出して、通知を登録します。Clients register for notifications by calling the IMsgStore::Advise method. クライアントのパスで、 IMAPIAdviseSink: IUnknownインタ フェースは、クライアントが受け取るでは通知の種類を示すビットマスク、アドバイズを格納、メッセージのどのオブジェクトを示すエントリ Id要求に適用されます。The client passes in an IMAPIAdviseSink : IUnknown interface, a bitmask that indicates what type of notifications the client is interested in receiving, and an EntryID that indicates which object in the message store the Advise request applies to. オブジェクト (たとえば、メッセージ ・ ストア内の受信フォルダーに新しいメッセージが到着したときなど) に関連するイベントが発生すると、メッセージ ストア プロバイダーまたはオブジェクト自体はメソッドを呼び出すIMAPIAdviseSink::OnNotify のすべてのIMAPIAdviseSinkそのイベントの種類に対して登録されているオブジェクト。When relevant events occur in the object (for example, when a new message arrives in the receive folder in the message store), the message store provider or the object itself should call the IMAPIAdviseSink::OnNotify method for all of the IMAPIAdviseSink objects that have registered for that event type.

場合でも、メッセージの格納プロバイダー決して通知メッセージ ・ ストア内の変更の場合は、他の MAPI コンポーネント MAPI_E_NO_SUPPORT を取得するIMsgStore::Adviseを実装する必要がありますが、します。Even if your message store provider never notifies other MAPI components of changes in the message store, it should still implement IMsgStore::Advise to return MAPI_E_NO_SUPPORT. プロバイダーを格納、メッセージからの通知が他のコンポーネントに通知されます。This informs other components not to expect notifications from the message store provider.

関連項目See also

[���b�Z�[�W�̃X�g�A�̋@�(message-store-features.md)Message Store Features