IMAPIViewContext::SetAdviseSinkIMAPIViewContext::SetAdviseSink

適用されます: OutlookApplies to: Outlook

ビューアーの変更についての通知を受信するフォームの登録を管理します。Manages a form's registration to receive notifications about changes in the viewer.

HRESULT SetAdviseSink(
LPMAPIFORMADVISESINK pmvns
);

ParametersParameters

pmvnspmvns

[in]フォームへのポインターでは、シンク オブジェクトまたは NULL を案内します。[in] Pointer to a form advise sink object or NULL.

�߂�lReturn value

S_OKS_OK

登録またはフォームの通知の取り消しに成功しました。The registration or cancellation for form notification succeeded.

備考Remarks

フォーム オブジェクトは、いずれかの登録フォーム ビューアーでの変更点について説明する前の登録をキャンセルするIMAPIViewContext::SetAdviseSinkメソッドを呼び出します。Form objects call the IMAPIViewContext::SetAdviseSink method to either register to learn about changes in the form viewer or cancel a prior registration. _Pmvns_を NULL に設定すると、フォームは、登録をキャンセルしようとします。When pmvns is set to NULL, the form wants to cancel a registration. 有効なフォームに_pmvns_ポイントは、シンクをアドバイス、フォームの今後の通知を登録しようとします。When pmvns points to a valid form advise sink, the form wants to register for future notifications.

実装者へのメモNotes to implementers

SetAdviseSinkにフォームが含まれていますとシンク ポインターの通知、通知をキャンセルするのには別のSetAdviseSink呼び出しが行われるまでは、オブジェクトへの参照を保持します。When SetAdviseSink includes a form advise sink pointer, keep a reference to it until another SetAdviseSink call is made to cancel notification. ビューアーで、新しいメッセージをロードするときに変更が発生したときに通知を送信します。Send a notification when a change occurs in your viewer and when you are loading a new message.

詳細については、送信およびフォームの通知の受信を参照してください。For more information, see Sending and Receiving Form Notifications.

MFCMAPI 参照MFCMAPI reference

MFCMAPI �T���v�� �R�[�h�ł́A���̕\��Q�Ƃ��Ă��������BFor MFCMAPI sample code, see the following table.

�t�@�C��File �֐�Function �R�����gComment
MyMAPIFormViewer.cppMyMAPIFormViewer.cpp
CMyMAPIFormViewer::SetAdviseSinkCMyMAPIFormViewer::SetAdviseSink
MFCMAPI では、この関数では、 IMAPIViewContext::SetAdviseSinkメソッドを実装します。MFCMAPI implements the IMAPIViewContext::SetAdviseSink method in this function.

関連項目See also

[�R��h �T���v���Ƃ��� MFCMAPIMFCMAPI as a Code Sample