IStorage::SetElementTimes メソッド (objidl.h)

  • [アーティクル]

SetElementTimes メソッドは、基になるファイル システムでこのメソッドがサポートされている場合に、指定されたストレージ要素の変更、アクセス、および作成時間を設定します。

構文

HRESULT SetElementTimes(
  [in] const OLECHAR  *pwcsName,
  [in] const FILETIME *pctime,
  [in] const FILETIME *patime,
  [in] const FILETIME *pmtime
);

パラメーター

[in] pwcsName

時刻を変更するストレージ オブジェクト要素の名前。 NULL の場合、時刻は要素の 1 つではなくルート ストレージに設定されます。

[in] pctime

要素の新しい作成時刻、または作成時刻を変更しない場合は NULL 。

[in] patime

要素の新しいアクセス時間か、アクセス時間を変更しない場合は NULL 。

[in] pmtime

要素の新しい変更時刻、または変更時刻を変更しない場合は NULL 。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK 時刻の値が正常に設定されました。
E_PENDING 非同期ストレージのみ: 要素のデータの一部またはすべてを現在使用できません。
STG_E_ACCESSDENIED 呼び出し元には、要素を変更するための十分なアクセス許可がありません。
STG_E_FILENOTFOUND 指定した名前の要素が存在しません。
STG_E_INSUFFICIENTMEMORY メモリがないため、要素は変更されませんでした。
STG_E_INVALIDNAME 要素名の有効な値ではありません。
STG_E_INVALIDPOINTER 要素に指定されたポインターが無効でした。
STG_E_INVALIDPARAMETER パラメーターの 1 つが無効でした。
STG_E_TOOMANYOPENFILES 開いているファイルが多すぎるため、要素は変更されませんでした。
STG_E_REVERTED ストレージ オブジェクトは、トランザクション ツリーの上にある元に戻す操作によって無効になっています。

注釈

SetElementTimes は、 このストレージ オブジェクト内の指定されたストレージ要素の時間統計を設定します。

すべてのファイル システムですべての時間値がサポートされているわけではありません。 このメソッドは、サポートされている時刻を設定し、残りの時間を無視します。 各時間値パラメーターには NULL を指定できます。変更を行う必要がないことを示します。

これらの時刻値を取得するには、 IStorage::Stat メソッドを呼び出します。

要件

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

こちらもご覧ください

IStorage - 複合ファイルの実装

IStorage::Stat