IAdviseSink インターフェイス (objidl.h)

[アーティクル]
08/25/2023

コンテナーやその他のオブジェクトが、目的のオブジェクトで発生したデータ変更、変更の表示、および複合ドキュメントの変更に関する通知を受信できるようにします。たとえば、コンテナーアプリケーションでは、リンクされたオブジェクトと埋め込みオブジェクトのキャッシュされたプレゼンテーションを最新の状態に保つために、このような通知が必要です。 IAdviseSink メソッドの呼び出しは非同期であるため、呼び出しが送信され、呼び出しの戻りを待たずに次の命令が実行されます。

アドバイザリ接続を存在させるには、通知を受信するオブジェクトが IAdviseSink を実装する必要があり、関心のあるオブジェクトは IOleObject::Advise と IDataObject::D Advise を実装する必要があります。インプロセスオブジェクトとハンドラーは、IViewObject::SetAdvise を実装することもできます。 IOleObject を実装するオブジェクトは、すべての妥当なアドバイザリメソッドをサポートする必要があります。アドバイザリ通知を簡略化するために、OLE は IDataAdviseHolder と IOleAdviseHolder の実装を提供します。この実装では、アドバイザリ接続を追跡し、 IAdviseSink インターフェイスへのポインターを介して適切なシンクに通知を送信します。 IViewObject (およびそのアドバイザリメソッド) は、既定のハンドラーに実装されます。

次の表に示すように、アドバイズシンクを実装したオブジェクトは、適切なメソッドを呼び出すことによって、特定の種類の通知を受信することに関心を登録します。

このメソッドを呼び出す	これらの通知に登録するには
IOleObject::Advise	ドキュメントを保存、閉じる、または名前を変更する場合。
IDataObject::D Advise	ドキュメントのデータが変更されたとき。
IViewObject::SetAdvise	ドキュメントのプレゼンテーションが変更されたとき。

登録された通知の種類に適用されるイベントが発生すると、オブジェクトアプリケーションは適切な IAdviseSink メソッドを呼び出します。たとえば、埋め込みオブジェクトが閉じると、 IAdviseSink::OnClose メソッドを呼び出してコンテナーに通知します。これらの通知は非同期であり、それらをトリガーするイベントの後に発生します。

継承

IAdviseSink インターフェイスは、IUnknown インターフェイスから継承されます。 IAdviseSink には、次の種類のメンバーもあります。

メソッド

IAdviseSink インターフェイスには、これらのメソッドがあります。


IAdviseSink::OnClose オブジェクトが実行中から読み込まれた状態に変更されたことをすべての登録済みアドバイザリシンクに通知するために、サーバーによって呼び出されます。
IAdviseSink::OnDataChange サーバーによって呼び出され、データオブジェクトの現在登録されている通知は、オブジェクト内のデータが変更されたことをシンクに通知します。
IAdviseSink::OnRename オブジェクトの名前が変更されたことをすべての登録済みアドバイザリシンクに通知するために、サーバーによって呼び出されます。
IAdviseSink::OnSave オブジェクトが保存されたことをすべての登録済みアドバイザリシンクに通知するために、サーバーによって呼び出されます。
IAdviseSink::OnViewChange オブジェクトの登録済みアドバイスシンクに、そのビューが変更されたことを通知します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	objidl.h