WIN32_FIND_DATAW構造体 (minwinbase.h)

[アーティクル]
11/20/2024

FindFirstFile、FindFirstFileEx、または FindNextFile 関数によって検出されたファイルに関する情報が含まれます。

構文

typedef struct _WIN32_FIND_DATAW {
  DWORD    dwFileAttributes;
  FILETIME ftCreationTime;
  FILETIME ftLastAccessTime;
  FILETIME ftLastWriteTime;
  DWORD    nFileSizeHigh;
  DWORD    nFileSizeLow;
  DWORD    dwReserved0;
  DWORD    dwReserved1;
  WCHAR    cFileName[MAX_PATH];
  WCHAR    cAlternateFileName[14];
  DWORD    dwFileType; // Obsolete. Do not use.
  DWORD    dwCreatorType; // Obsolete. Do not use
  WORD     wFinderFlags; // Obsolete. Do not use
} WIN32_FIND_DATAW, *PWIN32_FIND_DATAW, *LPWIN32_FIND_DATAW;

メンバーズ

dwFileAttributes

ファイルのファイル属性。

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

ファイルの FILE_ATTRIBUTE_SPARSE_FILE 属性は、ファイルのいずれかのストリームがスパースであった場合に設定されます。

ftCreationTime

FILETIME ファイルまたはディレクトリが作成された日時を指定する構造体です。

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

ftLastAccessTime

FILETIME 構造体。

ファイルの場合、構造体は、ファイルの最後の読み取り、書き込み、または実行可能ファイルの実行日時を指定します。

ディレクトリの場合、構造はディレクトリが作成されるタイミングを指定します。基になるファイルシステムが最終アクセス時刻をサポートしていない場合、このメンバーは 0 です。

FAT ファイルシステムでは、ファイルとディレクトリの両方に指定された日付は正しいですが、時刻は常に午前 0 時に設定されます。

ftLastWriteTime

FILETIME 構造体。

ファイルの場合、構造体は、ファイルが最後に書き込まれた、切り捨てられた、または上書きされた日時を指定します。たとえば、WriteFile または SetEndOfFile 使用する場合などです。ファイル属性またはセキュリティ記述子が変更された場合、日付と時刻は更新されません。

ディレクトリの場合、構造はディレクトリが作成されるタイミングを指定します。基になるファイルシステムが最終書き込み時刻をサポートしていない場合、このメンバーは 0 です。

nFileSizeHigh

ファイルサイズの高次 DWORD 値 (バイト単位)。

ファイルサイズが MAXDWORDより大きい場合場合を除き、この値は 0 です。

ファイルのサイズは、 (nFileSizeHigh * (MAXDWORD+1)) + nFileSizeLowと等しくなります。

nFileSizeLow

ファイルサイズの下位 DWORD 値 (バイト単位)。

dwReserved0

dwFileAttributes メンバーに FILE_ATTRIBUTE_REPARSE_POINT 属性が含まれている場合、このメンバーは再解析ポイントタグを指定します。

それ以外の場合、この値は未定義であり、使用しないでください。

詳細については、「再解析ポイントタグの」を参照してください。

IO_REPARSE_TAG_CSV (0x80000009)

IO_REPARSE_TAG_DEDUP (0x80000013)

IO_REPARSE_TAG_DFS (0x8000000A)

IO_REPARSE_TAG_DFSR (0x80000012)

IO_REPARSE_TAG_HSM (0xC0000004)

IO_REPARSE_TAG_HSM2 (0x80000006)

IO_REPARSE_TAG_MOUNT_POINT (0xA0000003)

IO_REPARSE_TAG_NFS (0x80000014)

IO_REPARSE_TAG_SIS (0x80000007)

IO_REPARSE_TAG_SYMLINK (0xA000000C)

IO_REPARSE_TAG_WIM (0x80000008)

dwReserved1

将来の使用のために予約されています。

cFileName[MAX_PATH]

ファイルの名前。

cAlternateFileName[14]

ファイルの別名。

この名前は、従来の 8.3 ファイル名形式です。

備考

ファイルに長いファイル名がある場合、完全な名前は cFileName メンバーに表示され、名前の 8.3 形式の切り捨てられたバージョンは、cAlternateFileName メンバーに表示されます。それ以外の場合、cAlternateFileName は空です。 FindFirstFileEx 関数が、fInfoLevelId パラメーターで FindExInfoBasic 値を使用して呼び出された場合、cAlternateFileName メンバーには常に NULL 文字列値が含まれます。これは、FindNextFile 関数への後続のすべての呼び出しに当てはまります。ファイル名の 8.3 形式バージョンを取得する別の方法として、GetShortPathName 関数を使用できます。ファイル名の詳細については、「ファイル名、パス、および名前空間の」を参照してください。

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

手記

minwinbase.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてWIN32_FIND_DATAを定義します。エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows XP [デスクトップアプリ \|UWP アプリ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップアプリ \|UWP アプリ]
ヘッダー	minwinbase.h (Windows.h を含む)

次の方法で共有