IOleLink::Update メソッド (oleidl.h)

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

リンクオブジェクトの複合ドキュメントのキャッシュデータを更新します。リンクソースがまだバインドされていない場合は、リンクソースへのバインドが含まれます。

構文

HRESULT Update(
  [in] IBindCtx *pbc
);

パラメーター

[in] pbc

リンクソースのバインドで使用されるバインドコンテキスト上の IBindCtx インターフェイスへのポインター。このパラメーターは、NULL でもかまいません。バインドコンテキストは、バインドプロセス中にバインドされたオブジェクトをキャッシュし、バインドコンテキストを使用するすべての操作に適用されるパラメーターを含み、バインド実装がその環境に関する情報を取得する手段を提供します。詳細については、「 IBindCtx」を参照してください。

戻り値

このメソッドは、成功したS_OKを返します。その他の可能な戻り値は次のとおりです。

リターンコード	説明
CACHE_E_NOCACHE_UPDATE	バインド操作は機能しましたが、キャッシュは更新されませんでした。
CACHE_S_SOMECACHES_NOTUPDATED	バインド操作は機能しましたが、すべてのキャッシュが更新されたわけではありません。
OLE_E_CANT_BINDTOSOURCE	リンクソースにバインドできません。

注釈

呼び出し元へのメモ

エンドユーザーがリンクオブジェクトのキャッシュされたデータを更新する場合、コンテナーアプリケーションは Update を呼び出す必要があります。

エンドユーザーは、[リンク] ダイアログボックスの [今すぐ更新] ボタンを選択して、リンクオブジェクトのキャッシュされたデータを更新できます。 OleUIEditLinks 関数を使用して [リンク] ダイアログボックスを表示する場合は、IOleUILinkContainer インターフェイスを実装する必要があります。このダイアログボックスでは、エンドユーザーが [今すぐ更新] ボタンを選択すると、IOleUILinkContainer::UpdateLink の実装が呼び出されます。そのメソッドの実装で Update を呼び出すことができます。

コンテナーアプリケーションは Update を呼び出してリンクオブジェクトを更新することもできます。これは、そのメソッドがリンクオブジェクトで呼び出されたときに Update を呼び出すからです。

このメソッドは、自動リンクと手動リンクの両方を更新します。手動リンクの場合は、 キャッシュを更新 する唯一の方法は Update または Update を呼び出すことです。自動リンクと手動リンクの詳細については、「 IOleLink::SetUpdateOptions」を参照してください。

実装に関する注意事項

pbc が NULL 以外の場合、リンクオブジェクトの Update の実装では、バインドされたリンクソースを登録するために IBindCtx::RegisterObjectBound が呼び出されます。これにより、バインドコンテキストが解放されるまでリンクソースが実行されたままになります。

リンクソースをバインドできない場合、現在のキャッシュはそのまま残ります。

要件

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