CFileFind::GetCreationTime

更新 : 2007 年 11 月

指定したファイルの作成日時を取得します。

virtual BOOL GetCreationTime(
   FILETIME* pTimeStamp 
) const;
virtual BOOL GetCreationTime(
   CTime& refTime 
) const;

パラメータ

• pTimeStamp
  ファイルの作成日時を保持している FILETIME 構造体へのポインタ。

• refTime
  CTime オブジェクトへの参照。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。GetCreationTime が 0 を返すのは、この CFileFind オブジェクトに対して FindNextFile が呼び出されていない場合だけです。

解説

GetCreationTime を呼び出す前に、少なくとも 1 回は FindNextFile を呼び出す必要があります。

メモ :
この関数が返すタイム スタンプ値を実装するときに、すべてのファイル システムが同じセマンティクスを使用するとは限りません。基本となるファイル システムまたはサーバーが時間属性を保持しない場合、この関数がほかのタイム スタンプ関数と同じ値を返すこともあります。時間書式の詳細については、Win32_FIND_DATA 構造体の説明を参照してください。オペレーティング システムによっては、ファイルが存在するコンピュータに設定されているローカル タイム ゾーンの時刻が返されることがあります。詳細については、Win32 の FileTimeToLocalFileTime API の説明を参照してください。

使用例

「CFileFind::GetLength」の例を参照してください。

必要条件

ヘッダー : afx.h

参照

参照

CFileFind クラス

階層図

その他の技術情報

CFileFind のメンバ