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

オブジェクト ハンドラーまたはリンク オブジェクトのデータまたはビュー キャッシュを更新します。

構文

HRESULT Update();

戻り値

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

リターン コード	説明
E_FAIL	操作が失敗しました。
OLE_E_CANT_BINDTOSOURCE	オブジェクトを実行して更新されたデータを取得できません。 オブジェクトは、何らかの理由で呼び出し元が使用できません。
CACHE_E_NOCACHE_UPDATED	キャッシュは更新されませんでした。
CACHE_S_SOMECACHES_NOTUPDATED	一部のキャッシュは更新されませんでした。

注釈

Update メソッドは、コンテナーがリンクされたオブジェクトと埋め込みオブジェクトでデータを更新し続ける方法を提供します。 リンク ソースが更新されている場合、リンク オブジェクトは古くなる可能性があります。 他のオブジェクトへのリンクを含む埋め込みオブジェクトも古くなる可能性があります。 リンクを含まない埋め込みオブジェクトは、そのデータが別のソースにリンクされていないため、古くなることはできません。

実装者へのメモ

コンテナーがリンク オブジェクトの IOleObject::Update メソッドを呼び出すと、リンク オブジェクトはリンク ソースを検索し、そこから新しいプレゼンテーションを取得します。 このプロセスには、1 つ以上のオブジェクト アプリケーションの実行も含まれる場合があり、これには時間がかかる可能性があります。

コンテナーは、埋め込みオブジェクトの IOleObject::Update メソッドを呼び出すときに、オブジェクトに含まれる可能性のあるすべてのリンク オブジェクトを更新するよう要求します。 応答として、オブジェクト ハンドラーは、必要に応じて各オブジェクトを実行して、独自のリンクされた各オブジェクトに対して IOleObject::Update を再帰的に呼び出します。

要件

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

こちらもご覧ください

IOleObject

IOleObject::IsUpToDate