ホーム › Storage.FileSystem › COPYFILE2_EXTENDED_PARAMETERS_V2

COPYFILE2_EXTENDED_PARAMETERS_V2

構造体

サイズx64: 112 バイト / x86: 64 バイト

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

フィールド

フィールド	型	サイズ	x64	x86	説明
dwSize	DWORD	4	+0	+0	この構造体のバイトサイズ。sizeofで設定する。
dwCopyFlags	COPYFILE_FLAGS	4	+4	+4	コピー動作を制御するフラグ(COPYFILE_FLAGS)。
pfCancel	BOOL*	8/4	+8	+8	TRUEを書き込むとコピーを中断するBOOLへのポインタ。
pProgressRoutine	PCOPYFILE2_PROGRESS_ROUTINE	8/4	+16	+12	CopyFile2形式の進捗通知コールバックへのポインタ。NULL可。
pvCallbackContext	void*	8/4	+24	+16	コールバックに渡されるユーザー定義コンテキスト。
dwCopyFlagsV2	COPYFILE2_V2_FLAGS	4	+32	+20	V2で追加された拡張コピー制御フラグ(COPYFILE2_V2_FLAGS)。
ioDesiredSize	DWORD	4	+36	+24	I/O要求の希望サイズ(バイト)。0で既定。
ioDesiredRate	DWORD	4	+40	+28	I/Oの希望転送レート。0で制限なし。
pProgressRoutineOld	LPPROGRESS_ROUTINE	8/4	+48	+32	旧式LPPROGRESS_ROUTINE形式の進捗コールバック。NULL可。
SourceOplockKeys	COPYFILE2_CREATE_OPLOCK_KEYS*	8/4	+56	+36	ソース側oplockキー群へのポインタ。NULL可。
reserved	void*	48/24	+64	+40	予約フィールド。NULLを設定する。

各言語での定義

#include <windows.h>

// COPYFILE2_EXTENDED_PARAMETERS_V2  (x64 112 / x86 64 バイト)
typedef struct COPYFILE2_EXTENDED_PARAMETERS_V2 {
    DWORD dwSize;
    COPYFILE_FLAGS dwCopyFlags;
    BOOL* pfCancel;
    PCOPYFILE2_PROGRESS_ROUTINE pProgressRoutine;
    void* pvCallbackContext;
    COPYFILE2_V2_FLAGS dwCopyFlagsV2;
    DWORD ioDesiredSize;
    DWORD ioDesiredRate;
    LPPROGRESS_ROUTINE pProgressRoutineOld;
    COPYFILE2_CREATE_OPLOCK_KEYS* SourceOplockKeys;
    void* reserved[6];
} COPYFILE2_EXTENDED_PARAMETERS_V2;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct COPYFILE2_EXTENDED_PARAMETERS_V2
{
    public uint dwSize;
    public uint dwCopyFlags;
    [MarshalAs(UnmanagedType.Bool)] public bool pfCancel;
    public IntPtr pProgressRoutine;
    public IntPtr pvCallbackContext;
    public uint dwCopyFlagsV2;
    public uint ioDesiredSize;
    public uint ioDesiredRate;
    public IntPtr pProgressRoutineOld;
    public IntPtr SourceOplockKeys;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 6)] public IntPtr[] reserved;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure COPYFILE2_EXTENDED_PARAMETERS_V2
    Public dwSize As UInteger
    Public dwCopyFlags As UInteger
    <MarshalAs(UnmanagedType.Bool)> Public pfCancel As Boolean
    Public pProgressRoutine As IntPtr
    Public pvCallbackContext As IntPtr
    Public dwCopyFlagsV2 As UInteger
    Public ioDesiredSize As UInteger
    Public ioDesiredRate As UInteger
    Public pProgressRoutineOld As IntPtr
    Public SourceOplockKeys As IntPtr
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=6)> Public reserved() As IntPtr
End Structure

import ctypes
from ctypes import wintypes

class COPYFILE2_EXTENDED_PARAMETERS_V2(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("dwCopyFlags", wintypes.DWORD),
        ("pfCancel", ctypes.c_void_p),
        ("pProgressRoutine", ctypes.c_void_p),
        ("pvCallbackContext", ctypes.c_void_p),
        ("dwCopyFlagsV2", wintypes.DWORD),
        ("ioDesiredSize", wintypes.DWORD),
        ("ioDesiredRate", wintypes.DWORD),
        ("pProgressRoutineOld", ctypes.c_void_p),
        ("SourceOplockKeys", ctypes.c_void_p),
        ("reserved", ctypes.c_void_p * 6),
    ]

#[repr(C)]
pub struct COPYFILE2_EXTENDED_PARAMETERS_V2 {
    pub dwSize: u32,
    pub dwCopyFlags: u32,
    pub pfCancel: *mut core::ffi::c_void,
    pub pProgressRoutine: *mut core::ffi::c_void,
    pub pvCallbackContext: *mut core::ffi::c_void,
    pub dwCopyFlagsV2: u32,
    pub ioDesiredSize: u32,
    pub ioDesiredRate: u32,
    pub pProgressRoutineOld: *mut core::ffi::c_void,
    pub SourceOplockKeys: *mut core::ffi::c_void,
    pub reserved: [*mut core::ffi::c_void; 6],
}

import "golang.org/x/sys/windows"

type COPYFILE2_EXTENDED_PARAMETERS_V2 struct {
	dwSize uint32
	dwCopyFlags uint32
	pfCancel uintptr
	pProgressRoutine uintptr
	pvCallbackContext uintptr
	dwCopyFlagsV2 uint32
	ioDesiredSize uint32
	ioDesiredRate uint32
	pProgressRoutineOld uintptr
	SourceOplockKeys uintptr
	reserved [6]uintptr
}

type
  COPYFILE2_EXTENDED_PARAMETERS_V2 = record
    dwSize: DWORD;
    dwCopyFlags: DWORD;
    pfCancel: Pointer;
    pProgressRoutine: Pointer;
    pvCallbackContext: Pointer;
    dwCopyFlagsV2: DWORD;
    ioDesiredSize: DWORD;
    ioDesiredRate: DWORD;
    pProgressRoutineOld: Pointer;
    SourceOplockKeys: Pointer;
    reserved: array[0..5] of Pointer;
  end;

const COPYFILE2_EXTENDED_PARAMETERS_V2 = extern struct {
    dwSize: u32,
    dwCopyFlags: u32,
    pfCancel: ?*anyopaque,
    pProgressRoutine: ?*anyopaque,
    pvCallbackContext: ?*anyopaque,
    dwCopyFlagsV2: u32,
    ioDesiredSize: u32,
    ioDesiredRate: u32,
    pProgressRoutineOld: ?*anyopaque,
    SourceOplockKeys: ?*anyopaque,
    reserved: [6]?*anyopaque,
};

type
  COPYFILE2_EXTENDED_PARAMETERS_V2 {.bycopy.} = object
    dwSize: uint32
    dwCopyFlags: uint32
    pfCancel: pointer
    pProgressRoutine: pointer
    pvCallbackContext: pointer
    dwCopyFlagsV2: uint32
    ioDesiredSize: uint32
    ioDesiredRate: uint32
    pProgressRoutineOld: pointer
    SourceOplockKeys: pointer
    reserved: array[6, pointer]

struct COPYFILE2_EXTENDED_PARAMETERS_V2
{
    uint dwSize;
    uint dwCopyFlags;
    void* pfCancel;
    void* pProgressRoutine;
    void* pvCallbackContext;
    uint dwCopyFlagsV2;
    uint ioDesiredSize;
    uint ioDesiredRate;
    void* pProgressRoutineOld;
    void* SourceOplockKeys;
    void*[6] reserved;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; COPYFILE2_EXTENDED_PARAMETERS_V2 サイズ: 64 バイト(x86)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwCopyFlags : COPYFILE_FLAGS (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; pfCancel : BOOL* (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; pProgressRoutine : PCOPYFILE2_PROGRESS_ROUTINE (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; pvCallbackContext : void* (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwCopyFlagsV2 : COPYFILE2_V2_FLAGS (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ioDesiredSize : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ioDesiredRate : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; pProgressRoutineOld : LPPROGRESS_ROUTINE (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; SourceOplockKeys : COPYFILE2_CREATE_OPLOCK_KEYS* (+36, 4byte)  varptr(st)+36 を基点に操作(4byte:入れ子/配列)
; reserved : void* (+40, 24byte)  varptr(st)+40 を基点に操作(24byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; COPYFILE2_EXTENDED_PARAMETERS_V2 サイズ: 112 バイト(x64)
dim st, 28    ; 4byte整数×28(構造体サイズ 112 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwCopyFlags : COPYFILE_FLAGS (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; pfCancel : BOOL* (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; pProgressRoutine : PCOPYFILE2_PROGRESS_ROUTINE (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; pvCallbackContext : void* (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; dwCopyFlagsV2 : COPYFILE2_V2_FLAGS (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ioDesiredSize : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; ioDesiredRate : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; pProgressRoutineOld : LPPROGRESS_ROUTINE (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; SourceOplockKeys : COPYFILE2_CREATE_OPLOCK_KEYS* (+56, 8byte)  varptr(st)+56 を基点に操作(8byte:入れ子/配列)
; reserved : void* (+64, 48byte)  varptr(st)+64 を基点に操作(48byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global COPYFILE2_EXTENDED_PARAMETERS_V2
    #field int dwSize
    #field int dwCopyFlags
    #field intptr pfCancel
    #field intptr pProgressRoutine
    #field intptr pvCallbackContext
    #field int dwCopyFlagsV2
    #field int ioDesiredSize
    #field int ioDesiredRate
    #field intptr pProgressRoutineOld
    #field intptr SourceOplockKeys
    #field intptr reserved 6
#endstruct

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

COPYFILE2_EXTENDED_PARAMETERS_V2

フィールド

各言語での定義

HSP用 定義

HSP用定義