ホーム › Storage.FileSystem › FILE_FULL_DIR_INFO
FILE_FULL_DIR_INFO
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| NextEntryOffset | DWORD | 4 | +0 | +0 | 返される次の FILE_FULL_DIR_INFO 構造体への オフセットです。このエントリの後に他のエントリが続かない場合は 0 が格納されます。 |
| FileIndex | DWORD | 4 | +4 | +4 | 親ディレクトリ内でのファイルのバイトオフセットです。NTFS のように、親ディレクトリ内での ファイルの位置が固定されておらず、並び順を維持するためにいつでも変更され得るファイルシステムでは、 このメンバーは未定義です。 |
| CreationTime | LONGLONG | 8 | +8 | +8 | ファイルが作成された時刻です。 |
| LastAccessTime | LONGLONG | 8 | +16 | +16 | ファイルに最後にアクセスした時刻です。 |
| LastWriteTime | LONGLONG | 8 | +24 | +24 | ファイルに最後に書き込みが行われた時刻です。 |
| ChangeTime | LONGLONG | 8 | +32 | +32 | ファイルが最後に変更された時刻です。 |
| EndOfFile | LONGLONG | 8 | +40 | +40 | ファイルの先頭から既定のデータストリームの末尾までのバイトオフセットで表した、新しいファイル終端位置の 絶対値です。この値は 0 から始まるため、実際にはファイル内の最初の空きバイトを指します。 言い換えると、EndOfFile はファイル内の最後の有効なバイトの直後に続くバイトへの オフセットです。 |
| AllocationSize | LONGLONG | 8 | +48 | +48 | ファイルに割り当てられているバイト数です。通常、この値は基になる物理デバイスのセクターサイズ またはクラスターサイズの倍数になります。 |
| FileAttributes | DWORD | 4 | +56 | +56 | ファイル属性です。このメンバーには、次の属性の有効な任意の組み合わせを指定できます。 FILE_ATTRIBUTE_ARCHIVE (0x00000020)FILE_ATTRIBUTE_COMPRESSED (0x00000800)FILE_ATTRIBUTE_DIRECTORY (0x00000010)FILE_ATTRIBUTE_HIDDEN (0x00000002)FILE_ATTRIBUTE_NORMAL (0x00000080)FILE_ATTRIBUTE_READONLY (0x00000001)FILE_ATTRIBUTE_SYSTEM (0x00000004)FILE_ATTRIBUTE_TEMPORARY (0x00000100) |
| FileNameLength | DWORD | 4 | +60 | +60 | ファイル名の長さです。 |
| EaSize | DWORD | 4 | +64 | +64 | ファイルの拡張属性のサイズです。 |
| FileName | WCHAR | 2 | +68 | +68 | ファイル名文字列の最初の文字です。メモリ上では、この後に文字列の残りの部分が 続きます。 |
公式ドキュメント
ファイルのディレクトリ情報を格納します。この構造体は、 FileInformationClass パラメーターに FileFullDirectoryInfo または FileFullDirectoryRestartInfo を 渡したときに GetFileInformationByHandleEx 関数から返されます。
解説(Remarks)
FILE_FULL_DIR_INFO 構造体は、 FILE_ID_BOTH_DIR_INFO 構造体が持つ情報のサブセットです。 追加の情報が不要であれば、情報はディレクトリエントリから取得されるため処理は高速になります。 FILE_ID_BOTH_DIR_INFO は、ディレクトリエントリとマスターファイルテーブル (MFT) の 両方から得られる情報を含みます。
この情報を照会するために特定のアクセス権は必要ありません。
すべての日付と時刻は絶対システム時刻形式です。絶対システム時刻とは、1601 年の初めからの 100 ナノ秒間隔の数です。
この FILE_FULL_DIR_INFO 構造体は、 LONGLONG (8 バイト) 境界に配置されている必要があります。バッファーに 2 つ以上のこれらの 構造体が含まれる場合、最後のエントリを除く各エントリの NextEntryOffset の値は 8 バイト境界になります。
この構造体を使用するアプリケーションをコンパイルするには、_WIN32_WINNT マクロを 0x0600 以降として定義してください。詳細については、 Using the Windows Headers を参照してください。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// FILE_FULL_DIR_INFO (x64 72 / x86 72 バイト)
typedef struct FILE_FULL_DIR_INFO {
DWORD NextEntryOffset;
DWORD FileIndex;
LONGLONG CreationTime;
LONGLONG LastAccessTime;
LONGLONG LastWriteTime;
LONGLONG ChangeTime;
LONGLONG EndOfFile;
LONGLONG AllocationSize;
DWORD FileAttributes;
DWORD FileNameLength;
DWORD EaSize;
WCHAR FileName[1];
} FILE_FULL_DIR_INFO;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FILE_FULL_DIR_INFO
{
public uint NextEntryOffset;
public uint FileIndex;
public long CreationTime;
public long LastAccessTime;
public long LastWriteTime;
public long ChangeTime;
public long EndOfFile;
public long AllocationSize;
public uint FileAttributes;
public uint FileNameLength;
public uint EaSize;
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 1)] public string FileName;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FILE_FULL_DIR_INFO
Public NextEntryOffset As UInteger
Public FileIndex As UInteger
Public CreationTime As Long
Public LastAccessTime As Long
Public LastWriteTime As Long
Public ChangeTime As Long
Public EndOfFile As Long
Public AllocationSize As Long
Public FileAttributes As UInteger
Public FileNameLength As UInteger
Public EaSize As UInteger
<MarshalAs(UnmanagedType.ByValTStr, SizeConst:=1)> Public FileName As String
End Structureimport ctypes
from ctypes import wintypes
class FILE_FULL_DIR_INFO(ctypes.Structure):
_fields_ = [
("NextEntryOffset", wintypes.DWORD),
("FileIndex", wintypes.DWORD),
("CreationTime", ctypes.c_longlong),
("LastAccessTime", ctypes.c_longlong),
("LastWriteTime", ctypes.c_longlong),
("ChangeTime", ctypes.c_longlong),
("EndOfFile", ctypes.c_longlong),
("AllocationSize", ctypes.c_longlong),
("FileAttributes", wintypes.DWORD),
("FileNameLength", wintypes.DWORD),
("EaSize", wintypes.DWORD),
("FileName", ctypes.c_wchar * 1),
]#[repr(C)]
pub struct FILE_FULL_DIR_INFO {
pub NextEntryOffset: u32,
pub FileIndex: u32,
pub CreationTime: i64,
pub LastAccessTime: i64,
pub LastWriteTime: i64,
pub ChangeTime: i64,
pub EndOfFile: i64,
pub AllocationSize: i64,
pub FileAttributes: u32,
pub FileNameLength: u32,
pub EaSize: u32,
pub FileName: [u16; 1],
}import "golang.org/x/sys/windows"
type FILE_FULL_DIR_INFO struct {
NextEntryOffset uint32
FileIndex uint32
CreationTime int64
LastAccessTime int64
LastWriteTime int64
ChangeTime int64
EndOfFile int64
AllocationSize int64
FileAttributes uint32
FileNameLength uint32
EaSize uint32
FileName [1]uint16
}type
FILE_FULL_DIR_INFO = record
NextEntryOffset: DWORD;
FileIndex: DWORD;
CreationTime: Int64;
LastAccessTime: Int64;
LastWriteTime: Int64;
ChangeTime: Int64;
EndOfFile: Int64;
AllocationSize: Int64;
FileAttributes: DWORD;
FileNameLength: DWORD;
EaSize: DWORD;
FileName: array[0..0] of WideChar;
end;const FILE_FULL_DIR_INFO = extern struct {
NextEntryOffset: u32,
FileIndex: u32,
CreationTime: i64,
LastAccessTime: i64,
LastWriteTime: i64,
ChangeTime: i64,
EndOfFile: i64,
AllocationSize: i64,
FileAttributes: u32,
FileNameLength: u32,
EaSize: u32,
FileName: [1]u16,
};type
FILE_FULL_DIR_INFO {.bycopy.} = object
NextEntryOffset: uint32
FileIndex: uint32
CreationTime: int64
LastAccessTime: int64
LastWriteTime: int64
ChangeTime: int64
EndOfFile: int64
AllocationSize: int64
FileAttributes: uint32
FileNameLength: uint32
EaSize: uint32
FileName: array[1, uint16]struct FILE_FULL_DIR_INFO
{
uint NextEntryOffset;
uint FileIndex;
long CreationTime;
long LastAccessTime;
long LastWriteTime;
long ChangeTime;
long EndOfFile;
long AllocationSize;
uint FileAttributes;
uint FileNameLength;
uint EaSize;
wchar[1] FileName;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; FILE_FULL_DIR_INFO サイズ: 72 バイト(x64)
dim st, 18 ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; NextEntryOffset : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; FileIndex : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; CreationTime : LONGLONG (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; LastAccessTime : LONGLONG (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; LastWriteTime : LONGLONG (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; ChangeTime : LONGLONG (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; EndOfFile : LONGLONG (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; AllocationSize : LONGLONG (+48, 8byte) qpoke st,48,値 / qpeek(st,48) ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; FileAttributes : DWORD (+56, 4byte) st.14 = 値 / 値 = st.14 (lpoke/lpeek も可)
; FileNameLength : DWORD (+60, 4byte) st.15 = 値 / 値 = st.15 (lpoke/lpeek も可)
; EaSize : DWORD (+64, 4byte) st.16 = 値 / 値 = st.16 (lpoke/lpeek も可)
; FileName : WCHAR (+68, 2byte) varptr(st)+68 を基点に操作(2byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global FILE_FULL_DIR_INFO
#field int NextEntryOffset
#field int FileIndex
#field int64 CreationTime
#field int64 LastAccessTime
#field int64 LastWriteTime
#field int64 ChangeTime
#field int64 EndOfFile
#field int64 AllocationSize
#field int FileAttributes
#field int FileNameLength
#field int EaSize
#field wchar FileName 1
#endstruct
stdim st, FILE_FULL_DIR_INFO ; NSTRUCT 変数を確保
st->NextEntryOffset = 100
mes "NextEntryOffset=" + st->NextEntryOffset