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

WIN32_FIND_DATAA

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

サイズ=各フィールドのバイト数(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将来の使用のために予約されています。
cFileNameCHAR260+44+44ファイルの名前です。
cAlternateFileNameCHAR14+304+304

ファイルの代替名です。

この名前は従来の 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_DATAA  (x64 320 / x86 320 バイト)
typedef struct WIN32_FIND_DATAA {
    DWORD dwFileAttributes;
    FILETIME ftCreationTime;
    FILETIME ftLastAccessTime;
    FILETIME ftLastWriteTime;
    DWORD nFileSizeHigh;
    DWORD nFileSizeLow;
    DWORD dwReserved0;
    DWORD dwReserved1;
    CHAR cFileName[260];
    CHAR cAlternateFileName[14];
} WIN32_FIND_DATAA;
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_DATAA
{
    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.ByValArray, SizeConst = 260)] public sbyte[] cFileName;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 14)] public sbyte[] 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_DATAA
    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.ByValArray, SizeConst:=260)> Public cFileName() As SByte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=14)> Public cAlternateFileName() As SByte
End Structure
import ctypes
from ctypes import wintypes

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

class WIN32_FIND_DATAA(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_byte * 260),
        ("cAlternateFileName", ctypes.c_byte * 14),
    ]
#[repr(C)]
pub struct FILETIME {
    pub dwLowDateTime: u32,
    pub dwHighDateTime: u32,
}

#[repr(C)]
pub struct WIN32_FIND_DATAA {
    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: [i8; 260],
    pub cAlternateFileName: [i8; 14],
}
import "golang.org/x/sys/windows"

type FILETIME struct {
	dwLowDateTime uint32
	dwHighDateTime uint32
}

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

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

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

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

struct WIN32_FIND_DATAA
{
    uint dwFileAttributes;
    FILETIME ftCreationTime;
    FILETIME ftLastAccessTime;
    FILETIME ftLastWriteTime;
    uint nFileSizeHigh;
    uint nFileSizeLow;
    uint dwReserved0;
    uint dwReserved1;
    byte[260] cFileName;
    byte[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_DATAA サイズ: 320 バイト(x64)
dim st, 80    ; 4byte整数×80(構造体サイズ 320 / 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 : CHAR (+44, 260byte)  varptr(st)+44 を基点に操作(260byte:入れ子/配列)
; cAlternateFileName : CHAR (+304, 14byte)  varptr(st)+304 を基点に操作(14byte:入れ子/配列)
; ※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_DATAA
    #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 byte cFileName 260
    #field byte cAlternateFileName 14
#endstruct

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