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

WIN32_FILE_ATTRIBUTE_DATA

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

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

フィールド

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

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

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

ftCreationTimeFILETIME8+4+4

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

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

ftLastAccessTimeFILETIME8+12+12

FILETIME 構造体です。

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

ディレクトリの場合、この構造体はディレクトリが作成された日時を指定します。

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

ftLastWriteTimeFILETIME8+20+20

FILETIME 構造体です。

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

ディレクトリの場合、この構造体はディレクトリが作成された日時を指定します。

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

nFileSizeHighDWORD4+28+28

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

このメンバーはディレクトリに対しては意味を持ちません。

nFileSizeLowDWORD4+32+32

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

このメンバーはディレクトリに対しては意味を持ちません。

公式ドキュメント

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

解説(Remarks)

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

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_FILE_ATTRIBUTE_DATA  (x64 36 / x86 36 バイト)
typedef struct WIN32_FILE_ATTRIBUTE_DATA {
    DWORD dwFileAttributes;
    FILETIME ftCreationTime;
    FILETIME ftLastAccessTime;
    FILETIME ftLastWriteTime;
    DWORD nFileSizeHigh;
    DWORD nFileSizeLow;
} WIN32_FILE_ATTRIBUTE_DATA;
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_FILE_ATTRIBUTE_DATA
{
    public uint dwFileAttributes;
    public FILETIME ftCreationTime;
    public FILETIME ftLastAccessTime;
    public FILETIME ftLastWriteTime;
    public uint nFileSizeHigh;
    public uint nFileSizeLow;
}
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_FILE_ATTRIBUTE_DATA
    Public dwFileAttributes As UInteger
    Public ftCreationTime As FILETIME
    Public ftLastAccessTime As FILETIME
    Public ftLastWriteTime As FILETIME
    Public nFileSizeHigh As UInteger
    Public nFileSizeLow As UInteger
End Structure
import ctypes
from ctypes import wintypes

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

class WIN32_FILE_ATTRIBUTE_DATA(ctypes.Structure):
    _fields_ = [
        ("dwFileAttributes", wintypes.DWORD),
        ("ftCreationTime", FILETIME),
        ("ftLastAccessTime", FILETIME),
        ("ftLastWriteTime", FILETIME),
        ("nFileSizeHigh", wintypes.DWORD),
        ("nFileSizeLow", wintypes.DWORD),
    ]
#[repr(C)]
pub struct FILETIME {
    pub dwLowDateTime: u32,
    pub dwHighDateTime: u32,
}

#[repr(C)]
pub struct WIN32_FILE_ATTRIBUTE_DATA {
    pub dwFileAttributes: u32,
    pub ftCreationTime: FILETIME,
    pub ftLastAccessTime: FILETIME,
    pub ftLastWriteTime: FILETIME,
    pub nFileSizeHigh: u32,
    pub nFileSizeLow: u32,
}
import "golang.org/x/sys/windows"

type FILETIME struct {
	dwLowDateTime uint32
	dwHighDateTime uint32
}

type WIN32_FILE_ATTRIBUTE_DATA struct {
	dwFileAttributes uint32
	ftCreationTime FILETIME
	ftLastAccessTime FILETIME
	ftLastWriteTime FILETIME
	nFileSizeHigh uint32
	nFileSizeLow uint32
}
type
  FILETIME = record
    dwLowDateTime: DWORD;
    dwHighDateTime: DWORD;
  end;

  WIN32_FILE_ATTRIBUTE_DATA = record
    dwFileAttributes: DWORD;
    ftCreationTime: FILETIME;
    ftLastAccessTime: FILETIME;
    ftLastWriteTime: FILETIME;
    nFileSizeHigh: DWORD;
    nFileSizeLow: DWORD;
  end;
const FILETIME = extern struct {
    dwLowDateTime: u32,
    dwHighDateTime: u32,
};

const WIN32_FILE_ATTRIBUTE_DATA = extern struct {
    dwFileAttributes: u32,
    ftCreationTime: FILETIME,
    ftLastAccessTime: FILETIME,
    ftLastWriteTime: FILETIME,
    nFileSizeHigh: u32,
    nFileSizeLow: u32,
};
type
  FILETIME {.bycopy.} = object
    dwLowDateTime: uint32
    dwHighDateTime: uint32

  WIN32_FILE_ATTRIBUTE_DATA {.bycopy.} = object
    dwFileAttributes: uint32
    ftCreationTime: FILETIME
    ftLastAccessTime: FILETIME
    ftLastWriteTime: FILETIME
    nFileSizeHigh: uint32
    nFileSizeLow: uint32
struct FILETIME
{
    uint dwLowDateTime;
    uint dwHighDateTime;
}

struct WIN32_FILE_ATTRIBUTE_DATA
{
    uint dwFileAttributes;
    FILETIME ftCreationTime;
    FILETIME ftLastAccessTime;
    FILETIME ftLastWriteTime;
    uint nFileSizeHigh;
    uint nFileSizeLow;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; WIN32_FILE_ATTRIBUTE_DATA サイズ: 36 バイト(x64)
dim st, 9    ; 4byte整数×9(構造体サイズ 36 / 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 も可)
; ※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_FILE_ATTRIBUTE_DATA
    #field int dwFileAttributes
    #field FILETIME ftCreationTime
    #field FILETIME ftLastAccessTime
    #field FILETIME ftLastWriteTime
    #field int nFileSizeHigh
    #field int nFileSizeLow
#endstruct

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