BY_HANDLE_FILE_INFORMATION
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| dwFileAttributes | DWORD | 4 | +0 | +0 | ファイル属性です。指定可能な値とその説明については、File Attribute Constants を参照してください。 |
| ftCreationTime | FILETIME | 8 | +4 | +4 | ファイルまたはディレクトリが作成された日時を指定する FILETIME 構造体です。基になるファイルシステムが作成日時をサポートしていない場合、このメンバーは 0 になります。 |
| ftLastAccessTime | FILETIME | 8 | +12 | +12 | FILETIME 構造体です。ファイルの場合、この構造体はファイルが最後に読み取られた日時、または書き込まれた日時を指定します。ディレクトリの場合は、ディレクトリが作成された日時を指定します。ファイルとディレクトリのいずれの場合も、指定される日付は正確ですが、時刻は常に午前 0 時に設定されます。基になるファイルシステムが最終アクセス日時をサポートしていない場合、このメンバーは 0 になります。 |
| ftLastWriteTime | FILETIME | 8 | +20 | +20 | FILETIME 構造体です。ファイルの場合、この構造体はファイルに最後に書き込まれた日時を指定します。ディレクトリの場合は、ディレクトリが作成された日時を指定します。基になるファイルシステムが最終書き込み日時をサポートしていない場合、このメンバーは 0 になります。 |
| dwVolumeSerialNumber | DWORD | 4 | +28 | +28 | ファイルが格納されているボリュームのシリアル番号です。 |
| nFileSizeHigh | DWORD | 4 | +32 | +32 | ファイルサイズの上位部分です。 |
| nFileSizeLow | DWORD | 4 | +36 | +36 | ファイルサイズの下位部分です。 |
| nNumberOfLinks | DWORD | 4 | +40 | +40 | このファイルへのリンクの数です。FAT ファイルシステムでは、このメンバーは常に 1 です。NTFS ファイルシステムでは、1 より大きくなる場合があります。 |
| nFileIndexHigh | DWORD | 4 | +44 | +44 | ファイルに関連付けられている一意の識別子の上位部分です。詳細については、nFileIndexLow を参照してください。 |
| nFileIndexLow | DWORD | 4 | +48 | +48 | ファイルに関連付けられている一意の識別子の下位部分です。 この識別子 (下位部分と上位部分) とボリュームシリアル番号によって、1 台のコンピューター上でファイルが一意に識別されます。開いている 2 つのハンドルが同じファイルを表しているかどうかを判断するには、各ファイルの識別子とボリュームシリアル番号を組み合わせて比較します。 Windows Server 2012 で導入された ReFS ファイルシステムは、128 ビットのファイル識別子をサポートします。128 ビットのファイル識別子を取得するには、GetFileInformationByHandleEx 関数に FileIdInfo を指定して FILE_ID_INFO 構造体を取得します。この構造体の 64 ビットの識別子は、ReFS では一意であることが保証されません。 |
公式ドキュメント
GetFileInformationByHandle 関数が取得する情報を格納します。
解説(Remarks)
nFileIndexHigh メンバーと nFileIndexLow メンバーに格納される識別子は、ファイル ID と呼ばれます。ファイル ID のサポートはファイルシステムに依存します。ファイルシステムはファイル ID を自由に再利用できるため、ファイル ID が時間の経過に対して一意であることは保証されません。場合によっては、ファイルのファイル ID が時間の経過とともに変化することがあります。
FAT ファイルシステムでは、ファイル ID はファイルを含むディレクトリの最初のクラスターと、そのディレクトリ内におけるファイルのエントリのバイトオフセットから生成されます。デフラグ製品の中には、このバイトオフセットを変更するものがあります (Windows に標準搭載されているデフラグでは変更されません)。したがって、FAT のファイル ID は時間の経過とともに変化する可能性があります。また、FAT ファイルシステムでファイル名を変更した場合も、新しいファイル名が以前のものより長い場合に限り、ファイル ID が変化することがあります。
NTFS ファイルシステムでは、ファイルが削除されるまで同じファイル ID が保持されます。ReplaceFile 関数を使用すると、ファイル ID を変更せずにファイルを別のファイルで置き換えることができます。ただし、結果として得られるファイルのファイル ID として保持されるのは、置き換えられたファイルではなく、置き換えに使用したファイルのファイル ID です。
すべてのファイルシステムが作成日時と最終アクセス日時を記録できるわけではなく、記録の方法もファイルシステムによって異なります。たとえば、Windows の FAT ファイルシステムでは、作成日時の分解能は 10 ミリ秒、書き込み日時の分解能は 2 秒、アクセス日時の分解能は 1 日 (アクセスした日付) です。NTFS ファイルシステムでは、アクセス日時の分解能は 1 時間です。詳細については、File Times を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// FILETIME (x64 8 / x86 8 バイト)
typedef struct FILETIME {
DWORD dwLowDateTime;
DWORD dwHighDateTime;
} FILETIME;
// BY_HANDLE_FILE_INFORMATION (x64 52 / x86 52 バイト)
typedef struct BY_HANDLE_FILE_INFORMATION {
DWORD dwFileAttributes;
FILETIME ftCreationTime;
FILETIME ftLastAccessTime;
FILETIME ftLastWriteTime;
DWORD dwVolumeSerialNumber;
DWORD nFileSizeHigh;
DWORD nFileSizeLow;
DWORD nNumberOfLinks;
DWORD nFileIndexHigh;
DWORD nFileIndexLow;
} BY_HANDLE_FILE_INFORMATION;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 BY_HANDLE_FILE_INFORMATION
{
public uint dwFileAttributes;
public FILETIME ftCreationTime;
public FILETIME ftLastAccessTime;
public FILETIME ftLastWriteTime;
public uint dwVolumeSerialNumber;
public uint nFileSizeHigh;
public uint nFileSizeLow;
public uint nNumberOfLinks;
public uint nFileIndexHigh;
public uint nFileIndexLow;
}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 BY_HANDLE_FILE_INFORMATION
Public dwFileAttributes As UInteger
Public ftCreationTime As FILETIME
Public ftLastAccessTime As FILETIME
Public ftLastWriteTime As FILETIME
Public dwVolumeSerialNumber As UInteger
Public nFileSizeHigh As UInteger
Public nFileSizeLow As UInteger
Public nNumberOfLinks As UInteger
Public nFileIndexHigh As UInteger
Public nFileIndexLow As UInteger
End Structureimport ctypes
from ctypes import wintypes
class FILETIME(ctypes.Structure):
_fields_ = [
("dwLowDateTime", wintypes.DWORD),
("dwHighDateTime", wintypes.DWORD),
]
class BY_HANDLE_FILE_INFORMATION(ctypes.Structure):
_fields_ = [
("dwFileAttributes", wintypes.DWORD),
("ftCreationTime", FILETIME),
("ftLastAccessTime", FILETIME),
("ftLastWriteTime", FILETIME),
("dwVolumeSerialNumber", wintypes.DWORD),
("nFileSizeHigh", wintypes.DWORD),
("nFileSizeLow", wintypes.DWORD),
("nNumberOfLinks", wintypes.DWORD),
("nFileIndexHigh", wintypes.DWORD),
("nFileIndexLow", wintypes.DWORD),
]#[repr(C)]
pub struct FILETIME {
pub dwLowDateTime: u32,
pub dwHighDateTime: u32,
}
#[repr(C)]
pub struct BY_HANDLE_FILE_INFORMATION {
pub dwFileAttributes: u32,
pub ftCreationTime: FILETIME,
pub ftLastAccessTime: FILETIME,
pub ftLastWriteTime: FILETIME,
pub dwVolumeSerialNumber: u32,
pub nFileSizeHigh: u32,
pub nFileSizeLow: u32,
pub nNumberOfLinks: u32,
pub nFileIndexHigh: u32,
pub nFileIndexLow: u32,
}import "golang.org/x/sys/windows"
type FILETIME struct {
dwLowDateTime uint32
dwHighDateTime uint32
}
type BY_HANDLE_FILE_INFORMATION struct {
dwFileAttributes uint32
ftCreationTime FILETIME
ftLastAccessTime FILETIME
ftLastWriteTime FILETIME
dwVolumeSerialNumber uint32
nFileSizeHigh uint32
nFileSizeLow uint32
nNumberOfLinks uint32
nFileIndexHigh uint32
nFileIndexLow uint32
}type
FILETIME = record
dwLowDateTime: DWORD;
dwHighDateTime: DWORD;
end;
BY_HANDLE_FILE_INFORMATION = record
dwFileAttributes: DWORD;
ftCreationTime: FILETIME;
ftLastAccessTime: FILETIME;
ftLastWriteTime: FILETIME;
dwVolumeSerialNumber: DWORD;
nFileSizeHigh: DWORD;
nFileSizeLow: DWORD;
nNumberOfLinks: DWORD;
nFileIndexHigh: DWORD;
nFileIndexLow: DWORD;
end;const FILETIME = extern struct {
dwLowDateTime: u32,
dwHighDateTime: u32,
};
const BY_HANDLE_FILE_INFORMATION = extern struct {
dwFileAttributes: u32,
ftCreationTime: FILETIME,
ftLastAccessTime: FILETIME,
ftLastWriteTime: FILETIME,
dwVolumeSerialNumber: u32,
nFileSizeHigh: u32,
nFileSizeLow: u32,
nNumberOfLinks: u32,
nFileIndexHigh: u32,
nFileIndexLow: u32,
};type
FILETIME {.bycopy.} = object
dwLowDateTime: uint32
dwHighDateTime: uint32
BY_HANDLE_FILE_INFORMATION {.bycopy.} = object
dwFileAttributes: uint32
ftCreationTime: FILETIME
ftLastAccessTime: FILETIME
ftLastWriteTime: FILETIME
dwVolumeSerialNumber: uint32
nFileSizeHigh: uint32
nFileSizeLow: uint32
nNumberOfLinks: uint32
nFileIndexHigh: uint32
nFileIndexLow: uint32struct FILETIME
{
uint dwLowDateTime;
uint dwHighDateTime;
}
struct BY_HANDLE_FILE_INFORMATION
{
uint dwFileAttributes;
FILETIME ftCreationTime;
FILETIME ftLastAccessTime;
FILETIME ftLastWriteTime;
uint dwVolumeSerialNumber;
uint nFileSizeHigh;
uint nFileSizeLow;
uint nNumberOfLinks;
uint nFileIndexHigh;
uint nFileIndexLow;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; BY_HANDLE_FILE_INFORMATION サイズ: 52 バイト(x64)
dim st, 13 ; 4byte整数×13(構造体サイズ 52 / 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:入れ子/配列)
; dwVolumeSerialNumber : DWORD (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; nFileSizeHigh : DWORD (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; nFileSizeLow : DWORD (+36, 4byte) st.9 = 値 / 値 = st.9 (lpoke/lpeek も可)
; nNumberOfLinks : DWORD (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; nFileIndexHigh : DWORD (+44, 4byte) st.11 = 値 / 値 = st.11 (lpoke/lpeek も可)
; nFileIndexLow : DWORD (+48, 4byte) st.12 = 値 / 値 = st.12 (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 BY_HANDLE_FILE_INFORMATION
#field int dwFileAttributes
#field FILETIME ftCreationTime
#field FILETIME ftLastAccessTime
#field FILETIME ftLastWriteTime
#field int dwVolumeSerialNumber
#field int nFileSizeHigh
#field int nFileSizeLow
#field int nNumberOfLinks
#field int nFileIndexHigh
#field int nFileIndexLow
#endstruct
stdim st, BY_HANDLE_FILE_INFORMATION ; NSTRUCT 変数を確保
st->dwFileAttributes = 100
mes "dwFileAttributes=" + st->dwFileAttributes