WIN32_FILE_ATTRIBUTE_DATA 構造体 (fileapi.h)

  • [アーティクル]

ファイルまたはディレクトリの属性情報が含まれます。 GetFileAttributesEx 関数は、この構造体を使用します。

構文

typedef struct _WIN32_FILE_ATTRIBUTE_DATA {
  DWORD    dwFileAttributes;
  FILETIME ftCreationTime;
  FILETIME ftLastAccessTime;
  FILETIME ftLastWriteTime;
  DWORD    nFileSizeHigh;
  DWORD    nFileSizeLow;
} WIN32_FILE_ATTRIBUTE_DATA, *LPWIN32_FILE_ATTRIBUTE_DATA;

メンバー

dwFileAttributes

ファイルまたはディレクトリのファイル システム属性情報。

使用できる値とその説明については、「 ファイル属性定数」を参照してください。

ftCreationTime

ファイルまたはディレクトリを作成するタイミングを指定する FILETIME 構造体。

基になるファイル システムが作成時間をサポートしていない場合、このメンバーは 0 です。

ftLastAccessTime

FILETIME 構造体。

ファイルの場合、 構造体は、ファイルが最後に読み取られたり書き込まれたりするタイミングを指定します。

ディレクトリの場合、 構造体は、ディレクトリを作成するタイミングを指定します。

ファイルとディレクトリの両方で、指定した日付は正しいですが、時刻は常に午前 0 時に設定されます。 基になるファイル システムが最終アクセス時刻をサポートしていない場合、このメンバーは 0 です。

ftLastWriteTime

FILETIME 構造体。

ファイルの場合、 構造体は、ファイルが最後に書き込まれる日時を指定します。

ディレクトリの場合、 構造体は、ディレクトリを作成するタイミングを指定します。

基になるファイル システムで前回の書き込み時刻がサポートされていない場合、このメンバーは 0 になります。

nFileSizeHigh

ファイル サイズの上位 DWORD 。

このメンバーにはディレクトリの意味がありません。

nFileSizeLow

ファイル サイズの下位 DWORD 。

このメンバーにはディレクトリの意味がありません。

注釈

すべてのファイル・システムが作成時刻と最終アクセス時刻を記録できるわけではありません。また、すべてのファイル・システムが同じ方法で記録するわけではありません。 たとえば、FAT ファイル システムでは、作成時間の解像度は 10 ミリ秒、書き込み時間の解像度は 2 秒、アクセス時間の解像度は 1 日です。 NTFS ファイル システムでは、アクセス時間の解像度は 1 時間です。 詳細については、「ファイル時間」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header fileapi.h (Windows.h、WinBase.h を含む)

こちらもご覧ください

ファイル属性定数

GetFileAttributesEx