CGopherFileFind::GetLastAccessTime

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

指定したファイルの最新アクセス日時を取得します。

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

パラメータ

refTime
CTime オブジェクトへの参照。
pTimeStamp
ファイルが前回アクセスされたときの日時を保持している FILETIME 構造体へのポインタ。

戻り値

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

解説

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

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

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