NOTIFKEYNOTIFKEY

適用されます: OutlookApplies to: Outlook

アドバイズ シンク、アドバイズ ソースと MAPI との間の接続を一意に識別します。Uniquely identifies a connection between an advise sink, an advise source, and MAPI.

ヘッダー ファイル:Header file:
Mapispi.hMapispi.h
typedef struct
{
  ULONG cb;
  BYTE ab[MAPI_DIM];
} NOTIFKEY, FAR *LPNOTIFKEY;

メンバーMembers

cbcb

Abメンバーのバイト数をカウントします。Count of bytes in the ab member.

abab

通知キーを記述するバイトの配列です。Array of bytes describing the notification key.

備考Remarks

IMAPISupport購読通知方法は、適切なアドバイスのソースに関する適切なアドバイズ シンクに通知を生成するのにNOTIFKEY構造体を使用します。The Subscribe and Notify methods of IMAPISupport use the NOTIFKEY structure to generate notifications to the appropriate advise sink about the appropriate advise source.

サービスのプロバイダーは、そのメソッドが呼び出され、通知の登録と通知のそれ以降の送信を処理するために購読を呼び出すときに通知キーを生成します。Service providers generate notification keys when their Advise method is called and they want to call Subscribe to handle the notification registration and the subsequent sending of notifications. アドバイズ ソースのエントリ id は、通知のキーまたは定数などの他の識別項目を指定できます。A notification key can be the entry identifier of the advise source or it can be any other identifying item such as a constant. などのメッセージ ストア プロバイダーでは、その通知キーとしてフォルダーのパスを使用する可能性があります。For example, a message store provider might use the path of a folder as its notification key.

通知キーは、複数のプロセス間で動作するはずです。The notification key should work across multiple processes.

通知キーのスコープ要件では、長期のエントリ id のようになります。The scope requirements for a notification key resemble those for a long-term entry identifier. ただし、エントリの識別子とは異なり通知キーをバイナリ比較する必要があります。However, unlike an entry identifier, a notification key must be binary-comparable. 通常、通知のキーには、オブジェクトに固有の他のプロバイダー固有情報の後にサービス ・ プロバイダーによって定義されたGUIDの値が含まれています。Typically, a notification key includes a GUID value defined by the service provider followed by other provider-specific information unique to the object.

管理するNOTIFKEY構造体の使用の詳細については、通知を生成するオブジェクトとアドバイズ シンクの接続には、イベント通知をサポートしているが参照してください。For a discussion of the use of the NOTIFKEY structure to manage the connections between the advise sinks and the objects that generate the notifications, see Supporting Event Notification.

関連項目See also

MAPI の構造MAPI Structures