Win32 API 日本語リファレンス
ホームUI.Shell › FILEDESCRIPTORW

FILEDESCRIPTORW

構造体
サイズx64: 592 バイト / x86: 592 バイトパッキング1

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

フィールド

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

構造体の他のどのメンバーが有効なデータを保持しているかを示すフラグの配列です。このメンバーには、次の値の組み合わせを指定できます。

FD_CLSID (0x00000001)

0x00000001。clsid メンバーが有効です。

FD_SIZEPOINT (0x00000002)

0x00000002。sizel メンバーと pointl メンバーが有効です。

FD_ATTRIBUTES (0x00000004)

0x00000004。dwFileAttributes メンバーが有効です。

FD_CREATETIME (0x00000008)

0x00000008。ftCreationTime メンバーが有効です。

FD_ACCESSTIME (0x00000010)

0x00000010。ftLastAccessTime メンバーが有効です。

FD_WRITESTIME (0x00000020)

0x00000020。ftLastWriteTime メンバーが有効です。

FD_FILESIZE (0x00000040)

0x00000040。nFileSizeHigh メンバーと nFileSizeLow メンバーが有効です。

FD_PROGRESSUI (0x00004000)

0x00004000。ドラッグ アンド ドロップ操作時に進行状況インジケーターが表示されます。

FD_LINKUI (0x00008000)

0x00008000。この操作をショートカットとして扱います。

FD_UNICODE ((int)0x80000000)

(int)0x80000000。Windows Vista 以降。ディスクリプターが Unicode です。

clsidGUID16+4+4ファイルの種類の識別子です。
sizelSIZE8+20+20ファイル アイコンの幅と高さです。
pointlPOINTL8+28+28ファイル オブジェクトのスクリーン座標です。
dwFileAttributesDWORD4+36+36ファイル属性フラグです。GetFileAttributes で説明されている FILE_ATTRIBUTE_ 値の組み合わせになります。
ftCreationTimeFILETIME8+40+40ファイルの作成時刻を格納する FILETIME 構造体です。
ftLastAccessTimeFILETIME8+48+48ファイルが最後にアクセスされた時刻を格納する FILETIME 構造体です。
ftLastWriteTimeFILETIME8+56+56最後に書き込みが行われた時刻を格納する FILETIME 構造体です。
nFileSizeHighDWORD4+64+64ファイル サイズ (バイト単位) の上位 DWORD です。
nFileSizeLowDWORD4+68+68ファイル サイズ (バイト単位) の下位 DWORD です。
cFileNameWCHAR520+72+72

ファイル名を格納する、null で終わる文字列です。

- dwFlags.FD_ACCESSTIME (0x00000010)

0x00000010。ftLastAccessTime メンバーが有効です。

- dwFlags.FD_ATTRIBUTES (0x00000004)

0x00000004。dwFileAttributes メンバーが有効です。

- dwFlags.FD_CLSID (0x00000001)

0x00000001。clsid メンバーが有効です。

- dwFlags.FD_CREATETIME (0x00000008)

0x00000008。ftCreationTime メンバーが有効です。

- dwFlags.FD_FILESIZE (0x00000040)

0x00000040。nFileSizeHigh メンバーと nFileSizeLow メンバーが有効です。

- dwFlags.FD_LINKUI (0x00008000)

0x00008000。この操作をショートカットとして扱います。

- dwFlags.FD_PROGRESSUI (0x00004000)

0x00004000。ドラッグ アンド ドロップ操作時に進行状況インジケーターが表示されます。

- dwFlags.FD_SIZEPOINT (0x00000002)

0x00000002。sizel メンバーと pointl メンバーが有効です。

- dwFlags.FD_UNICODE ((int)0x80000000)

(int)0x80000000。Windows Vista 以降。ディスクリプターが Unicode です。

- dwFlags.FD_WRITESTIME (0x00000020)

0x00000020。ftLastWriteTime メンバーが有効です。

公式ドキュメント

Microsoft ActiveX の ドラッグ アンド ドロップ 操作中に、クリップボードを介してコピーされるファイルのプロパティを記述します。

解説(Remarks)

この構造体に対応する CFSTR_FILECONTENTS 形式がファイルをグローバル メモリ オブジェクトとして保持している場合、nFileSizeHighnFileSizeLow は、関連付けられたメモリ ブロックのサイズを指定します。これらが設定されている場合は、ユーザー インターフェイスを表示する必要があるときにも使用できます。たとえば、ファイルが上書きされようとしている場合、通常はこの構造体の情報を使用して、ファイルのサイズ、データ、名前を含むダイアログ ボックスを表示します。

長さ 0 のファイルを作成するには、dwFlagsFD_FILESIZE フラグを設定し、nFileSizeHighnFileSizeLow を 0 に設定します。CFSTR_FILECONTENTS 形式では、ファイルをストリームまたはグローバル メモリ オブジェクト (TYMED_ISTREAM または TYMED_HGLOBAL) として表す必要があります。

メモ

shlobj_core.h ヘッダーは FILEDESCRIPTOR をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に応じて、この関数の ANSI 版と Unicode 版が自動的に選択されます。エンコードに依存しないエイリアスと、エンコードに依存するコードを混在させると、不一致が生じてコンパイル エラーや実行時エラーの原因になることがあります。詳細については、関数プロトタイプの規則 を参照してください。

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

各言語での定義

#include <windows.h>

// SIZE  (x64 8 / x86 8 バイト)
typedef struct SIZE {
    INT cx;
    INT cy;
} SIZE;

// POINTL  (x64 8 / x86 8 バイト)
typedef struct POINTL {
    INT x;
    INT y;
} POINTL;

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

// FILEDESCRIPTORW  (x64 592 / x86 592 バイト)
#pragma pack(push, 1)
typedef struct FILEDESCRIPTORW {
    DWORD dwFlags;
    GUID clsid;
    SIZE sizel;
    POINTL pointl;
    DWORD dwFileAttributes;
    FILETIME ftCreationTime;
    FILETIME ftLastAccessTime;
    FILETIME ftLastWriteTime;
    DWORD nFileSizeHigh;
    DWORD nFileSizeLow;
    WCHAR cFileName[260];
} FILEDESCRIPTORW;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SIZE
{
    public int cx;
    public int cy;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct POINTL
{
    public int x;
    public int y;
}

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

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct FILEDESCRIPTORW
{
    public uint dwFlags;
    public Guid clsid;
    public SIZE sizel;
    public POINTL pointl;
    public uint dwFileAttributes;
    public FILETIME ftCreationTime;
    public FILETIME ftLastAccessTime;
    public FILETIME ftLastWriteTime;
    public uint nFileSizeHigh;
    public uint nFileSizeLow;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 260)] public string cFileName;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SIZE
    Public cx As Integer
    Public cy As Integer
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure POINTL
    Public x As Integer
    Public y As Integer
End Structure

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

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure FILEDESCRIPTORW
    Public dwFlags As UInteger
    Public clsid As Guid
    Public sizel As SIZE
    Public pointl As POINTL
    Public dwFileAttributes As UInteger
    Public ftCreationTime As FILETIME
    Public ftLastAccessTime As FILETIME
    Public ftLastWriteTime As FILETIME
    Public nFileSizeHigh As UInteger
    Public nFileSizeLow As UInteger
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=260)> Public cFileName As String
End Structure
import ctypes
from ctypes import wintypes

class SIZE(ctypes.Structure):
    _fields_ = [
        ("cx", ctypes.c_int),
        ("cy", ctypes.c_int),
    ]

class POINTL(ctypes.Structure):
    _fields_ = [
        ("x", ctypes.c_int),
        ("y", ctypes.c_int),
    ]

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

class FILEDESCRIPTORW(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("dwFlags", wintypes.DWORD),
        ("clsid", GUID),
        ("sizel", SIZE),
        ("pointl", POINTL),
        ("dwFileAttributes", wintypes.DWORD),
        ("ftCreationTime", FILETIME),
        ("ftLastAccessTime", FILETIME),
        ("ftLastWriteTime", FILETIME),
        ("nFileSizeHigh", wintypes.DWORD),
        ("nFileSizeLow", wintypes.DWORD),
        ("cFileName", ctypes.c_wchar * 260),
    ]
#[repr(C)]
pub struct SIZE {
    pub cx: i32,
    pub cy: i32,
}

#[repr(C)]
pub struct POINTL {
    pub x: i32,
    pub y: i32,
}

#[repr(C)]
pub struct FILETIME {
    pub dwLowDateTime: u32,
    pub dwHighDateTime: u32,
}

#[repr(C, packed(1))]
pub struct FILEDESCRIPTORW {
    pub dwFlags: u32,
    pub clsid: GUID,
    pub sizel: SIZE,
    pub pointl: POINTL,
    pub dwFileAttributes: u32,
    pub ftCreationTime: FILETIME,
    pub ftLastAccessTime: FILETIME,
    pub ftLastWriteTime: FILETIME,
    pub nFileSizeHigh: u32,
    pub nFileSizeLow: u32,
    pub cFileName: [u16; 260],
}
import "golang.org/x/sys/windows"

type SIZE struct {
	cx int32
	cy int32
}

type POINTL struct {
	x int32
	y int32
}

type FILETIME struct {
	dwLowDateTime uint32
	dwHighDateTime uint32
}

type FILEDESCRIPTORW struct {
	dwFlags uint32
	clsid windows.GUID
	sizel SIZE
	pointl POINTL
	dwFileAttributes uint32
	ftCreationTime FILETIME
	ftLastAccessTime FILETIME
	ftLastWriteTime FILETIME
	nFileSizeHigh uint32
	nFileSizeLow uint32
	cFileName [260]uint16
}
type
  SIZE = record
    cx: Integer;
    cy: Integer;
  end;

  POINTL = record
    x: Integer;
    y: Integer;
  end;

  FILETIME = record
    dwLowDateTime: DWORD;
    dwHighDateTime: DWORD;
  end;

  FILEDESCRIPTORW = packed record
    dwFlags: DWORD;
    clsid: TGUID;
    sizel: SIZE;
    pointl: POINTL;
    dwFileAttributes: DWORD;
    ftCreationTime: FILETIME;
    ftLastAccessTime: FILETIME;
    ftLastWriteTime: FILETIME;
    nFileSizeHigh: DWORD;
    nFileSizeLow: DWORD;
    cFileName: array[0..259] of WideChar;
  end;
const SIZE = extern struct {
    cx: i32,
    cy: i32,
};

const POINTL = extern struct {
    x: i32,
    y: i32,
};

const FILETIME = extern struct {
    dwLowDateTime: u32,
    dwHighDateTime: u32,
};

const FILEDESCRIPTORW = extern struct {
    dwFlags: u32,
    clsid: GUID,
    sizel: SIZE,
    pointl: POINTL,
    dwFileAttributes: u32,
    ftCreationTime: FILETIME,
    ftLastAccessTime: FILETIME,
    ftLastWriteTime: FILETIME,
    nFileSizeHigh: u32,
    nFileSizeLow: u32,
    cFileName: [260]u16,
};
type
  SIZE {.bycopy.} = object
    cx: int32
    cy: int32

  POINTL {.bycopy.} = object
    x: int32
    y: int32

  FILETIME {.bycopy.} = object
    dwLowDateTime: uint32
    dwHighDateTime: uint32

  FILEDESCRIPTORW {.packed.} = object
    dwFlags: uint32
    clsid: GUID
    sizel: SIZE
    pointl: POINTL
    dwFileAttributes: uint32
    ftCreationTime: FILETIME
    ftLastAccessTime: FILETIME
    ftLastWriteTime: FILETIME
    nFileSizeHigh: uint32
    nFileSizeLow: uint32
    cFileName: array[260, uint16]
struct SIZE
{
    int cx;
    int cy;
}

struct POINTL
{
    int x;
    int y;
}

struct FILETIME
{
    uint dwLowDateTime;
    uint dwHighDateTime;
}

align(1)
struct FILEDESCRIPTORW
{
    uint dwFlags;
    GUID clsid;
    SIZE sizel;
    POINTL pointl;
    uint dwFileAttributes;
    FILETIME ftCreationTime;
    FILETIME ftLastAccessTime;
    FILETIME ftLastWriteTime;
    uint nFileSizeHigh;
    uint nFileSizeLow;
    wchar[260] cFileName;
}

HSP用 定義

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

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

#defstruct global SIZE
    #field int cx
    #field int cy
#endstruct

#defstruct global POINTL
    #field int x
    #field int y
#endstruct

#defstruct global FILETIME
    #field int dwLowDateTime
    #field int dwHighDateTime
#endstruct

#defstruct global FILEDESCRIPTORW, pack=1
    #field int dwFlags
    #field GUID clsid
    #field SIZE sizel
    #field POINTL pointl
    #field int dwFileAttributes
    #field FILETIME ftCreationTime
    #field FILETIME ftLastAccessTime
    #field FILETIME ftLastWriteTime
    #field int nFileSizeHigh
    #field int nFileSizeLow
    #field wchar cFileName 260
#endstruct

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