SHNAMEMAPPINGA
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| pszOldPath | LPSTR | 8/4 | +0 | +0 | 古いパス名を格納する文字バッファーのアドレスです。 |
| pszNewPath | LPSTR | 8/4 | +8 | +4 | 新しいパス名を格納する文字バッファーのアドレスです。 |
| cchOldPath | INT | 4 | +16 | +8 | pszOldPath の文字数です。 |
| cchNewPath | INT | 4 | +20 | +12 | pszNewPath の文字数です。 |
公式ドキュメント
SHFileOperation 関数によって移動、コピー、または名前変更された各ファイルの、古いパス名と新しいパス名を格納します。
解説(Remarks)
この構造体には、ANSI 版 (SHFILEOPSTRUCTA) と Unicode 版 (SHFILEOPSTRUCTW) の 2 つのバージョンがあります。Unicode 版は、ANSI 文字列 (LPCSTR) の代わりにワイド文字列 (LPCWSTR) が使用される点を除き、ANSI 版と同一です。Windows 98 以前では、ANSI 版のみがサポートされます。Microsoft Windows NT 4.0 以降では、この構造体の ANSI 版と Unicode 版の両方がサポートされます。SHNAMEMAPPINGA と SHNAMEMAPPINGW を直接使用しないでください。アプリケーションが ANSI と Unicode のどちらでコンパイルされるかに応じて、プリコンパイラーによって適切な構造体が SHNAMEMAPPING として再定義されます。
shellapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして、SHNAMEMAPPING を定義します。エンコーディングに依存しないエイリアスの使用と、エンコーディングに依存するコードとを混在させると、不一致が生じ、コンパイルエラーや実行時エラーの原因となることがあります。詳細については、「Conventions for Function Prototypes」を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// SHNAMEMAPPINGA (x64 24 / x86 16 バイト)
#pragma pack(push, 1)
typedef struct SHNAMEMAPPINGA {
LPSTR pszOldPath;
LPSTR pszNewPath;
INT cchOldPath;
INT cchNewPath;
} SHNAMEMAPPINGA;
#pragma pack(pop)using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct SHNAMEMAPPINGA
{
public IntPtr pszOldPath;
public IntPtr pszNewPath;
public int cchOldPath;
public int cchNewPath;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure SHNAMEMAPPINGA
Public pszOldPath As IntPtr
Public pszNewPath As IntPtr
Public cchOldPath As Integer
Public cchNewPath As Integer
End Structureimport ctypes
from ctypes import wintypes
class SHNAMEMAPPINGA(ctypes.Structure):
_pack_ = 1
_fields_ = [
("pszOldPath", ctypes.c_void_p),
("pszNewPath", ctypes.c_void_p),
("cchOldPath", ctypes.c_int),
("cchNewPath", ctypes.c_int),
]#[repr(C, packed(1))]
pub struct SHNAMEMAPPINGA {
pub pszOldPath: *mut core::ffi::c_void,
pub pszNewPath: *mut core::ffi::c_void,
pub cchOldPath: i32,
pub cchNewPath: i32,
}import "golang.org/x/sys/windows"
type SHNAMEMAPPINGA struct {
pszOldPath uintptr
pszNewPath uintptr
cchOldPath int32
cchNewPath int32
}type
SHNAMEMAPPINGA = packed record
pszOldPath: Pointer;
pszNewPath: Pointer;
cchOldPath: Integer;
cchNewPath: Integer;
end;const SHNAMEMAPPINGA = extern struct {
pszOldPath: ?*anyopaque,
pszNewPath: ?*anyopaque,
cchOldPath: i32,
cchNewPath: i32,
};type
SHNAMEMAPPINGA {.packed.} = object
pszOldPath: pointer
pszNewPath: pointer
cchOldPath: int32
cchNewPath: int32align(1)
struct SHNAMEMAPPINGA
{
void* pszOldPath;
void* pszNewPath;
int cchOldPath;
int cchNewPath;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; SHNAMEMAPPINGA サイズ: 16 バイト(x86)
dim st, 4 ; 4byte整数×4(構造体サイズ 16 / 4 切り上げ)
; pszOldPath : LPSTR (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; pszNewPath : LPSTR (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; cchOldPath : INT (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; cchNewPath : INT (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SHNAMEMAPPINGA サイズ: 24 バイト(x64)
dim st, 6 ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; pszOldPath : LPSTR (+0, 8byte) qpoke st,0,値 / qpeek(st,0) ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; pszNewPath : LPSTR (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; cchOldPath : INT (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; cchNewPath : INT (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global SHNAMEMAPPINGA, pack=1
#field intptr pszOldPath
#field intptr pszNewPath
#field int cchOldPath
#field int cchNewPath
#endstruct
stdim st, SHNAMEMAPPINGA ; NSTRUCT 変数を確保
st->cchOldPath = 100
mes "cchOldPath=" + st->cchOldPath