IPropertyStorage::SetTimes メソッド (propidlbase.h)

SetTimes メソッドは、実装でサポートされている場合、このプロパティ セットの変更、アクセス、および作成時間を設定します。 すべての実装でこれらの時間値がすべてサポートされているわけではありません。

構文

HRESULT SetTimes(
  [in] const FILETIME *pctime,
  [in] const FILETIME *patime,
  [in] const FILETIME *pmtime
);

パラメーター

[in] pctime

プロパティ セットの新しい作成時刻へのポインター。 この呼び出しによって今回が変更されないことを示す NULL を指定できます。

[in] patime

プロパティ セットの新しいアクセス時間へのポインター。 この呼び出しによって今回が変更されないことを示す NULL を指定できます。

[in] pmtime

プロパティ セットの新しい変更時刻へのポインター。 この呼び出しによって今回が変更されないことを示す NULL を指定できます。

戻り値

このメソッドは、次に加えて、標準の戻り値E_UNEXPECTEDをサポートしています。

注釈

実装でサポートされている場合は、現在開いているプロパティ セットの変更、アクセス、および作成時間を設定します (すべての実装でこれらの時間値がすべてサポートされているわけではありません)。 サポートされていないタイム スタンプは常に 0 として報告され、呼び出し元がサポートをテストできるようになります。 IPropertyStorage::Stat の呼び出しは、(他のデータの中でも) タイムスタンプ情報を提供します。

この機能は、 IPropertySetStorage でメソッドとして提供されるのとは対照的に、既に開かれているプロパティ ストレージ オブジェクトの IPropertyStorage メソッドとして提供されることに注意してください。 通常、 SetTimes メソッドが明示的に呼び出されない場合、プロパティ セットの読み取りと書き込みの副作用として、アクセス時間と変更時間が更新されます。 SetTimes が使用されている場合、指定された最新の時刻は、SetTimes の以前の呼び出しで指定された既定の時刻または時刻の値よりも優先されます。

要件

関連項目

FILETIME

IPropertyStorage

IPropertyStorage::Stat