Win32 API 日本語リファレンス
ホームStorage.FileSystem › WIN32_FIND_DATAW

WIN32_FIND_DATAW

構造体
サイズx64: 592 バイト / x86: 592 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
dwFileAttributesDWORD4+0+0

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

指定可能な値とその説明については、 File Attribute Constants を参照してください。

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

ftCreationTimeFILETIME8+4+4

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

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

ftLastAccessTimeFILETIME8+12+12

FILETIME 構造体です。

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

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

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

ftLastWriteTimeFILETIME8+20+20

FILETIME 構造体です。

ファイルの場合、この構造体はファイルが最後に書き込まれた日時、切り詰められた日時、または上書きされた日時 (たとえば WriteFileSetEndOfFile が使用されたとき) を指定します。ファイル属性やセキュリティ記述子が変更されても、この日時は更新されません。

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

nFileSizeHighDWORD4+28+28

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

ファイルサイズが MAXDWORD より大きくない限り、この値は 0 になります。

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

nFileSizeLowDWORD4+32+32ファイルサイズの下位 DWORD 値 (バイト単位) です。
dwReserved0DWORD4+36+36

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

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

詳細については、Reparse Point Tags を参照してください。

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)

dwReserved1DWORD4+40+40将来の使用のために予約済みです。
cFileNameWCHAR520+44+44ファイルの名前です。
cAlternateFileNameWCHAR28+564+564

ファイルの代替名です。

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

公式ドキュメント

<a href="/windows/desktop/api/fileapi/nf-fileapi-findfirstfilea">FindFirstFile</a>、
<a href="/windows/desktop/api/fileapi/nf-fileapi-findfirstfileexa">FindFirstFileEx</a>、または
<a href="/windows/desktop/api/fileapi/nf-fileapi-findnextfilea">FindNextFile</a> 関数によって検出されたファイルに関する情報を格納します。

解説(Remarks)

ファイルが長いファイル名を持つ場合、完全な名前が cFileName メンバーに格納され、 8.3 形式に切り詰められた名前が cAlternateFileName メンバーに格納されます。それ以外の場合、cAlternateFileName は空になります。 FindFirstFileEx 関数が fInfoLevelId パラメーターに FindExInfoBasic の値を指定して呼び出された場合、cAlternateFileName メンバーには常に NULL 文字列値が格納されます。これは、以降のすべての FindNextFile 関数の呼び出しについても同様です。ファイル名の 8.3 形式のバージョンを取得する代替方法として、 GetShortPathName 関数を使用できます。ファイル名の詳細については、File Names, Paths, and Namespaces を参照してください。

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

メモ

minwinbase.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして WIN32_FIND_DATA を定義しています。エンコーディング中立のエイリアスの使用と、エンコーディング中立でないコードを混在させると、不一致が生じてコンパイルエラーや実行時エラーの原因となる場合があります。詳細については、Conventions for Function Prototypes を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// FILETIME  (x64 8 / x86 8 バイト)
typedef struct FILETIME {
    DWORD dwLowDateTime;
    DWORD dwHighDateTime;
} FILETIME;

// WIN32_FIND_DATAW  (x64 592 / x86 592 バイト)
typedef struct WIN32_FIND_DATAW {
    DWORD dwFileAttributes;
    FILETIME ftCreationTime;
    FILETIME ftLastAccessTime;
    FILETIME ftLastWriteTime;
    DWORD nFileSizeHigh;
    DWORD nFileSizeLow;
    DWORD dwReserved0;
    DWORD dwReserved1;
    WCHAR cFileName[260];
    WCHAR cAlternateFileName[14];
} WIN32_FIND_DATAW;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FILETIME
{
    public uint dwLowDateTime;
    public uint dwHighDateTime;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct WIN32_FIND_DATAW
{
    public uint dwFileAttributes;
    public FILETIME ftCreationTime;
    public FILETIME ftLastAccessTime;
    public FILETIME ftLastWriteTime;
    public uint nFileSizeHigh;
    public uint nFileSizeLow;
    public uint dwReserved0;
    public uint dwReserved1;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 260)] public string cFileName;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 14)] public string cAlternateFileName;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FILETIME
    Public dwLowDateTime As UInteger
    Public dwHighDateTime As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure WIN32_FIND_DATAW
    Public dwFileAttributes As UInteger
    Public ftCreationTime As FILETIME
    Public ftLastAccessTime As FILETIME
    Public ftLastWriteTime As FILETIME
    Public nFileSizeHigh As UInteger
    Public nFileSizeLow As UInteger
    Public dwReserved0 As UInteger
    Public dwReserved1 As UInteger
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=260)> Public cFileName As String
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=14)> Public cAlternateFileName As String
End Structure
import ctypes
from ctypes import wintypes

class FILETIME(ctypes.Structure):
    _fields_ = [
        ("dwLowDateTime", wintypes.DWORD),
        ("dwHighDateTime", wintypes.DWORD),
    ]

class WIN32_FIND_DATAW(ctypes.Structure):
    _fields_ = [
        ("dwFileAttributes", wintypes.DWORD),
        ("ftCreationTime", FILETIME),
        ("ftLastAccessTime", FILETIME),
        ("ftLastWriteTime", FILETIME),
        ("nFileSizeHigh", wintypes.DWORD),
        ("nFileSizeLow", wintypes.DWORD),
        ("dwReserved0", wintypes.DWORD),
        ("dwReserved1", wintypes.DWORD),
        ("cFileName", ctypes.c_wchar * 260),
        ("cAlternateFileName", ctypes.c_wchar * 14),
    ]
#[repr(C)]
pub struct FILETIME {
    pub dwLowDateTime: u32,
    pub dwHighDateTime: u32,
}

#[repr(C)]
pub struct WIN32_FIND_DATAW {
    pub dwFileAttributes: u32,
    pub ftCreationTime: FILETIME,
    pub ftLastAccessTime: FILETIME,
    pub ftLastWriteTime: FILETIME,
    pub nFileSizeHigh: u32,
    pub nFileSizeLow: u32,
    pub dwReserved0: u32,
    pub dwReserved1: u32,
    pub cFileName: [u16; 260],
    pub cAlternateFileName: [u16; 14],
}
import "golang.org/x/sys/windows"

type FILETIME struct {
	dwLowDateTime uint32
	dwHighDateTime uint32
}

type WIN32_FIND_DATAW struct {
	dwFileAttributes uint32
	ftCreationTime FILETIME
	ftLastAccessTime FILETIME
	ftLastWriteTime FILETIME
	nFileSizeHigh uint32
	nFileSizeLow uint32
	dwReserved0 uint32
	dwReserved1 uint32
	cFileName [260]uint16
	cAlternateFileName [14]uint16
}
type
  FILETIME = record
    dwLowDateTime: DWORD;
    dwHighDateTime: DWORD;
  end;

  WIN32_FIND_DATAW = record
    dwFileAttributes: DWORD;
    ftCreationTime: FILETIME;
    ftLastAccessTime: FILETIME;
    ftLastWriteTime: FILETIME;
    nFileSizeHigh: DWORD;
    nFileSizeLow: DWORD;
    dwReserved0: DWORD;
    dwReserved1: DWORD;
    cFileName: array[0..259] of WideChar;
    cAlternateFileName: array[0..13] of WideChar;
  end;
const FILETIME = extern struct {
    dwLowDateTime: u32,
    dwHighDateTime: u32,
};

const WIN32_FIND_DATAW = extern struct {
    dwFileAttributes: u32,
    ftCreationTime: FILETIME,
    ftLastAccessTime: FILETIME,
    ftLastWriteTime: FILETIME,
    nFileSizeHigh: u32,
    nFileSizeLow: u32,
    dwReserved0: u32,
    dwReserved1: u32,
    cFileName: [260]u16,
    cAlternateFileName: [14]u16,
};
type
  FILETIME {.bycopy.} = object
    dwLowDateTime: uint32
    dwHighDateTime: uint32

  WIN32_FIND_DATAW {.bycopy.} = object
    dwFileAttributes: uint32
    ftCreationTime: FILETIME
    ftLastAccessTime: FILETIME
    ftLastWriteTime: FILETIME
    nFileSizeHigh: uint32
    nFileSizeLow: uint32
    dwReserved0: uint32
    dwReserved1: uint32
    cFileName: array[260, uint16]
    cAlternateFileName: array[14, uint16]
struct FILETIME
{
    uint dwLowDateTime;
    uint dwHighDateTime;
}

struct WIN32_FIND_DATAW
{
    uint dwFileAttributes;
    FILETIME ftCreationTime;
    FILETIME ftLastAccessTime;
    FILETIME ftLastWriteTime;
    uint nFileSizeHigh;
    uint nFileSizeLow;
    uint dwReserved0;
    uint dwReserved1;
    wchar[260] cFileName;
    wchar[14] cAlternateFileName;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; WIN32_FIND_DATAW サイズ: 592 バイト(x64)
dim st, 148    ; 4byte整数×148(構造体サイズ 592 / 4 切り上げ)
; dwFileAttributes : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; ftCreationTime : FILETIME (+4, 8byte)  varptr(st)+4 を基点に操作(8byte:入れ子/配列)
; ftLastAccessTime : FILETIME (+12, 8byte)  varptr(st)+12 を基点に操作(8byte:入れ子/配列)
; ftLastWriteTime : FILETIME (+20, 8byte)  varptr(st)+20 を基点に操作(8byte:入れ子/配列)
; nFileSizeHigh : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; nFileSizeLow : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; dwReserved0 : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; dwReserved1 : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; cFileName : WCHAR (+44, 520byte)  varptr(st)+44 を基点に操作(520byte:入れ子/配列)
; cAlternateFileName : WCHAR (+564, 28byte)  varptr(st)+564 を基点に操作(28byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global FILETIME
    #field int dwLowDateTime
    #field int dwHighDateTime
#endstruct

#defstruct global WIN32_FIND_DATAW
    #field int dwFileAttributes
    #field FILETIME ftCreationTime
    #field FILETIME ftLastAccessTime
    #field FILETIME ftLastWriteTime
    #field int nFileSizeHigh
    #field int nFileSizeLow
    #field int dwReserved0
    #field int dwReserved1
    #field wchar cFileName 260
    #field wchar cAlternateFileName 14
#endstruct

stdim st, WIN32_FIND_DATAW        ; NSTRUCT 変数を確保
st->dwFileAttributes = 100
mes "dwFileAttributes=" + st->dwFileAttributes