IMAPIForm::Advise
適用対象: Outlook 2013 | Outlook 2016
フォームに影響を与えるイベントに関する通知用のフォーム ビューアーを登録します。
HRESULT Advise(
LPMAPIVIEWADVISESINK pAdvise,
ULONG FAR * pulConnection
);
パラメーター
pAdvise
[in]ビューへのポインターは、後続の通知を受信するようにシンク オブジェクトに通知します。
pulConnection
[out]正常な通知登録を表す 0 以外の値へのポインター。
戻り値
S_OK
登録が成功しました。
E_OUTOFMEMORY
メモリ不足のため、登録が失敗しました。
注釈
フォームビューアーはフォームの IMAPIForm::Advise メソッドを呼び出して、フォームに変更が発生したときに通知を登録します。
実装に関するメモ
pAdvise パラメーターで渡されたシンク ポインターは、ビューのコピーをそのまま使用して、イベントが発生したときに適切な IMAPIViewAdviseSink メソッドを呼び出すことができるようにします。 通知の登録が取り消されるまでポインターを保持するには、シンクの IUnknown::AddRef メソッドを呼び出します。 pulConnection パラメーターの内容を 0 以外の数値に設定します。
多くのフォームでは、登録とそれに続くイベントの通知を処理するヘルパー オブジェクトが実装されています。
一般的な通知プロセスの詳細については、「 MAPI でのイベント通知」を参照してください。
通知とフォームの詳細については、「フォーム通知の 送受信」を参照してください。