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

CSFV

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

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

フィールド

フィールドサイズx64x86説明
cbSizeDWORD4+0+0この構造体のサイズをバイト単位で指定する。
pshfIShellFolder*8/4+8+4ビュー対象の IShellFolder へのポインタ。
psvOuterIShellView*8/4+16+8集約のための外側 IShellView へのポインタ。NULL 可。
pidlITEMIDLIST*8/4+24+12対象フォルダーのPIDLへのポインタ。
lEventsINT4+32+16ビューが受信する変更通知イベントのフラグ。
pfnCallbackLPFNVIEWCALLBACK8/4+40+20ビュー動作をカスタマイズするコールバック関数 LPFNVIEWCALLBACK。
fvmFOLDERVIEWMODE4+48+24初期のフォルダー表示モードを指定する FOLDERVIEWMODE。

各言語での定義

#include <windows.h>

// CSFV  (x64 56 / x86 28 バイト)
typedef struct CSFV {
    DWORD cbSize;
    IShellFolder* pshf;
    IShellView* psvOuter;
    ITEMIDLIST* pidl;
    INT lEvents;
    LPFNVIEWCALLBACK pfnCallback;
    FOLDERVIEWMODE fvm;
} CSFV;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CSFV
{
    public uint cbSize;
    public IntPtr pshf;
    public IntPtr psvOuter;
    public IntPtr pidl;
    public int lEvents;
    public IntPtr pfnCallback;
    public int fvm;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CSFV
    Public cbSize As UInteger
    Public pshf As IntPtr
    Public psvOuter As IntPtr
    Public pidl As IntPtr
    Public lEvents As Integer
    Public pfnCallback As IntPtr
    Public fvm As Integer
End Structure
import ctypes
from ctypes import wintypes

class CSFV(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("pshf", ctypes.c_void_p),
        ("psvOuter", ctypes.c_void_p),
        ("pidl", ctypes.c_void_p),
        ("lEvents", ctypes.c_int),
        ("pfnCallback", ctypes.c_void_p),
        ("fvm", ctypes.c_int),
    ]
#[repr(C)]
pub struct CSFV {
    pub cbSize: u32,
    pub pshf: *mut core::ffi::c_void,
    pub psvOuter: *mut core::ffi::c_void,
    pub pidl: *mut core::ffi::c_void,
    pub lEvents: i32,
    pub pfnCallback: *mut core::ffi::c_void,
    pub fvm: i32,
}
import "golang.org/x/sys/windows"

type CSFV struct {
	cbSize uint32
	pshf uintptr
	psvOuter uintptr
	pidl uintptr
	lEvents int32
	pfnCallback uintptr
	fvm int32
}
type
  CSFV = record
    cbSize: DWORD;
    pshf: Pointer;
    psvOuter: Pointer;
    pidl: Pointer;
    lEvents: Integer;
    pfnCallback: Pointer;
    fvm: Integer;
  end;
const CSFV = extern struct {
    cbSize: u32,
    pshf: ?*anyopaque,
    psvOuter: ?*anyopaque,
    pidl: ?*anyopaque,
    lEvents: i32,
    pfnCallback: ?*anyopaque,
    fvm: i32,
};
type
  CSFV {.bycopy.} = object
    cbSize: uint32
    pshf: pointer
    psvOuter: pointer
    pidl: pointer
    lEvents: int32
    pfnCallback: pointer
    fvm: int32
struct CSFV
{
    uint cbSize;
    void* pshf;
    void* psvOuter;
    void* pidl;
    int lEvents;
    void* pfnCallback;
    int fvm;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CSFV サイズ: 28 バイト(x86)
dim st, 7    ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; pshf : IShellFolder* (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; psvOuter : IShellView* (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; pidl : ITEMIDLIST* (+12, 4byte)  varptr(st)+12 を基点に操作(4byte:入れ子/配列)
; lEvents : INT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; pfnCallback : LPFNVIEWCALLBACK (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; fvm : FOLDERVIEWMODE (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CSFV サイズ: 56 バイト(x64)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; pshf : IShellFolder* (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; psvOuter : IShellView* (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; pidl : ITEMIDLIST* (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; lEvents : INT (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; pfnCallback : LPFNVIEWCALLBACK (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; fvm : FOLDERVIEWMODE (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CSFV
    #field int cbSize
    #field intptr pshf
    #field intptr psvOuter
    #field intptr pidl
    #field int lEvents
    #field intptr pfnCallback
    #field int fvm
#endstruct

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