IMoniker::GetTimeOfLastChange メソッド (objidl.h)

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

このモニカーによって識別されたオブジェクトが最後に変更された時刻を取得します。

構文

HRESULT GetTimeOfLastChange(
  [in]  IBindCtx *pbc,
  [in]  IMoniker *pmkToLeft,
  [out] FILETIME *pFileTime
);

パラメーター

[in] pbc

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

[in] pmkToLeft

モニカーが複合モニカーの一部である場合は、このモニカーの左側にあるモニカーへのポインター。このパラメーターは、複合モニカーのさまざまなコンポーネント間の連携を可能にするために、モニカー実装者によって主に使用されます。モニカークライアントは NULL を渡す必要があります。

[out] pFileTime

前回の変更時刻を受け取る FILETIME 構造体へのポインター。 {0xFFFFFFFF,0x7FFFFFFF} の値は、エラー (制限時間を超えた場合、情報が利用できないなど) を示します。

戻り値

このメソッドは、E_OUTOFMEMORY標準の戻り値と、次の値を返すことができます。

リターンコード	説明
S_OK	メソッドは正常に完了しました。
MK_E_EXCEEDEDDEADLINE	バインド操作は、バインドコンテキストの BIND_OPTS 構造体で指定された制限時間内に完了できませんでした。
MK_E_CONNECTMANUALLY	この操作は、ネットワークデバイスに接続できなかったために、このオブジェクトのストレージに接続できませんでした。詳細については、「 IMoniker::BindToObject」を参照してください。
MK_E_UNAVAILABLE	変更の時刻は使用できず、使用されている期限に関係なく使用できなくなります。

注釈

正確には、返される時刻は、変更が発生しなかった後に COM が識別できる最も早い時刻であるため、この時刻はオブジェクトに対する最後の変更の時刻よりも遅い場合があります。

呼び出し元へのメモ

モニカーによって識別されるオブジェクトによって返される情報をキャッシュする場合は、情報が最新であることを確認できます。これを行うには、 GetTimeOfLastChange を 呼び出し、返された時刻と、オブジェクトから最後に情報を取得した時刻を比較します。

リンクオブジェクト内に格納されているモニカーの場合、 GetTimeOfLastChange は、主に IOleObject::IsUpToDate の既定のハンドラーの実装によって呼び出されます。コンテナーアプリケーションは IOleObject::IsUpToDate を呼び出して、リンクオブジェクト (またはリンクオブジェクトを含む埋め込みオブジェクト) が、オブジェクトに実際にバインドされずに最新の状態であるかどうかを判断します。これにより、アプリケーションは、エンドユーザーがドキュメントを開いたときに更新が必要なリンクオブジェクトをすばやく特定できます。その後、アプリケーションは、ドキュメント内のすべてのリンクオブジェクトをバインドするのではなく、更新が必要なリンクオブジェクトのみをバインドできます (エンドユーザーに更新するかどうかを確認するように求められた後)。

実装者へのメモ

リンクされたオブジェクトの場合、このメソッドはユーザーが最初に複合ドキュメントを開いたときに呼び出されるため、この操作を迅速に実行することが重要です。そのため、 GetTimeOfLastChange 実装はどのオブジェクトにもバインドしないでください。さらに、実装ではバインドコンテキストで deadline パラメーターをチェックし、指定した時間までに操作を完了できない場合はMK_E_EXCEEDEDDEADLINEを返す必要があります。

実装で使用できるいくつかの戦略を次に示します。

多くの種類のモニカーの場合、pmkToLeft パラメーターは、このモニカーによって識別されるオブジェクトのコンテナーを識別します。これがモニカークラスに当てはまる場合は、pmkToLeft パラメーターで GetTimeOfLastChange を呼び出すだけで済みます。これは、オブジェクトがコンテナーより後の日付に変更できないためです。
実行中のオブジェクトテーブル (ROT) へのポインターを取得するには、pbc パラメーターで IBindCtx::GetRunningObjectTable を呼び出し、次に IRunningObjectTable::GetTimeOfLastChange を呼び出します。ROT は通常、最後の変更時刻を記録するためです。
このモニカー (または pmkToLeft モニカー) に関連付けられているストレージを取得し、 IStorage::Stat の呼び出しでストレージの最終変更時刻を返すことができます。

実装固有の注意事項

実装	メモ
アンチモニカー	このメソッドは、E_NOTIMPLを返します。
クラスモニカー	このメソッドは、MK_E_UNAVAILABLEを返します。
ファイルモニカー	このモニカーが ROT 内にある場合、このメソッドは、そこに登録されている最後の変更時刻を返します。それ以外の場合は、ファイルの最後の書き込み時刻を返します。ファイルが見つからない場合、このメソッドは MK_E_NOOBJECTを返します。
汎用複合モニカー	このメソッドは、pmkToLeft (NULL 以外の場合) とこのモニカーの複合を作成し、ROT を使用して最後の変更時刻を取得します。オブジェクトが ROT 内にない場合、メソッドは複合の右端のコンポーネントで GetTimeOfLastChange を再帰的に呼び出し、その呼び出しの pmkToLeft パラメーターとして複合の残りの部分を渡します。
アイテムモニカー	pmkToLeft が NULL の場合、このメソッドは MK_E_NOTBINDABLEを返します。それ以外の場合、メソッドは pmkToLeft とこのモニカーの複合を作成し、ROT を使用して最後の変更時刻にアクセスします。オブジェクトが ROT に含まれていない場合、メソッドは pmkToLeft パラメーターで GetTimeOfLastChange を呼び出します。
OBJREF モニカー	このメソッドは、E_NOTIMPLを返します。
ポインターモニカー	このメソッドは、E_NOTIMPLを返します。
URL モニカー	このメソッドは、ROT に登録されているオブジェクトの最後の変更時刻を返します。

要件

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

こちらもご覧ください

Imoniker

IRunningObjectTable::GetTimeOfLastChange

Share via