IOleObject::IsUpToDate メソッド (oleidl.h)
オブジェクトが最新かどうかを確認します。
構文
HRESULT IsUpToDate();
戻り値
このメソッドは、オブジェクトが最新の場合にS_OKを返します。それ以外の場合は、S_FALSE。 その他の可能な戻り値は次のとおりです。
リターン コード | 説明 |
---|---|
|
オブジェクトの状態をタイムリーに判断することはできません。 |
注釈
IOleObject::IsUpToDate メソッドは、すべてのオブジェクトが最新の状態であるかどうかをコンテナーが再帰的にチェックする方法を提供します。 つまり、コンテナーが最初のオブジェクトでこのメソッドを呼び出すと、オブジェクトはすべてのオブジェクトに対して呼び出され、すべてのオブジェクトがチェックされるまですべてのオブジェクトに対して呼び出されます。
実装者へのメモ
IOleObject::IsUpToDate の再帰的な性質により、オブジェクトが古いかどうか (特に 1 つ以上の他のオブジェクトを含むオブジェクト) が古いかどうかを判断するには、最初の場所でオブジェクトを更新するのと同じくらい時間がかかる場合があります。 この型の長いクエリを避けたい場合は、 IOleObject::IsUpToDate がOLE_E_UNAVAILABLEを返すようにしてください。 クエリ対象のオブジェクトが小さく、オブジェクト自体が含まれず、効率的なクエリを可能にする場合、このメソッドはS_OKまたはS_FALSEを返すことができます。要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | oleidl.h |