CreateOleAdviseHolder

複合ドキュメント通知を管理するためのアドバイスホルダオブジェクトを作成する。このオブジェクトの IOleAdviseHolder インターフェイスの OLE 実装へのポインタを返す。

CreateOleAdviseHolder ppOAHolder

ppOAHolder : [var] 新しいアドバイスホルダオブジェクトへのインターフェイスポインタを受け取る IOleAdviseHolder ポインタ変数のアドレス。

(プラグイン / モジュール : ole32.dll)

解説

複合ドキュメント通知を管理するためのアドバイスホルダオブジェクトを作成する。このオブジェクトの IOleAdviseHolder
インターフェイスの OLE 実装へのポインタを返す。

[戻り値]
この関数は成功時に S_OK を返し、標準の戻り値 E_OUTOFMEMORY をサポートする。

[備考]
CreateOleAdviseHolder 関数は、IOleAdviseHolder インターフェイスの OLE
実装をサポートするアドバイスホルダのインスタンスを作成する。このインターフェイスのメソッドは、IOleObject
のアドバイザリメソッドを実装するため、またアドバイザリシンクをサポートするオブジェクトとの間にアドバイザリ接続が確立されたときに、オブジェクトの変更通知をアドバイザリシンクに送信するために使用される。CreateOleAdviseHolder
が返すアドバイスホルダは大多数のアプリケーションで十分な機能を提供する。ただし、OLE 提供の実装は
IOleAdviseHolder::EnumAdvise
をサポートしていないため、このメソッドを使用する必要がある場合は、独自のアドバイスホルダを実装する必要がある。

情報