SHELLEXECUTEINFOW
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| cbSize | DWORD | 4 | +0 | +0 | 必須です。この構造体のサイズ (バイト単位)。 | ||||||||||||||||||||||||||||||||||||||||||||
| fMask | DWORD | 4 | +4 | +4 | 他の構造体メンバーの内容と有効性を示す、次の値の 1 つ以上を組み合わせたものです:
| ||||||||||||||||||||||||||||||||||||||||||||
| hwnd | HWND | 8/4 | +8 | +8 | 省略可能です。所有者ウィンドウへのハンドルです。この関数の実行中にシステムが表示する可能性のある UI の表示と位置指定に使用されます。 | ||||||||||||||||||||||||||||||||||||||||||||
| lpVerb | LPWSTR | 8/4 | +16 | +12 | 実行するアクションを指定する、verb (動詞) と呼ばれる文字列です。使用できる verb は、対象となるファイルやフォルダーによって異なります。一般に、オブジェクトのショートカット メニューから利用できるアクションが、使用可能な verb です。このパラメーターは NULL にすることができ、その場合は既定の verb が利用できればそれが使用されます。利用できない場合は ":::no-loc text="open"::" verb が使用されます。どちらの verb も利用できない場合、システムはレジストリに最初に登録されている verb を使用します。次の verb がよく使用されます:
| ||||||||||||||||||||||||||||||||||||||||||||
| lpFile | LPWSTR | 8/4 | +24 | +16 | ShellExecuteEx が lpVerb パラメーターで指定されたアクションを実行する対象となる、ファイルまたはオブジェクトの名前を指定する、null 終端文字列のアドレスです。ShellExecuteEx 関数がサポートするシステム レジストリの verb には、実行可能ファイルおよびドキュメント ファイルに対する ":::no-loc text="open"::" と、印刷ハンドラーが登録されているドキュメント ファイルに対する ":::no-loc text="print"::" があります。他のアプリケーションが、.avi ファイルや .wav ファイルに対する ":::no-loc text="play"::" のような Shell verb をシステム レジストリに追加している場合もあります。シェル名前空間オブジェクトを指定するには、完全修飾された解析名を渡し、fMask パラメーターに SEE_MASK_INVOKEIDLIST フラグを設定します。 Note: SEE_MASK_INVOKEIDLIST フラグが設定されている場合、アイテムをファイル システム パスで識別するには lpFile を、PIDL で識別するには lpIDList を使用できます。lpFile と lpIDList のいずれか一方は設定しなければなりません。
Note: 名前にパスが含まれていない場合は、カレント ディレクトリが想定されます。 | ||||||||||||||||||||||||||||||||||||||||||||
| lpParameters | LPWSTR | 8/4 | +32 | +20 | 省略可能です。アプリケーションのパラメーターを格納する null 終端文字列のアドレスです。パラメーターはスペースで区切らなければなりません。lpFile メンバーがドキュメント ファイルを指定している場合、lpParameters は NULL にしてください。 | ||||||||||||||||||||||||||||||||||||||||||||
| lpDirectory | LPWSTR | 8/4 | +40 | +24 | 省略可能です。作業ディレクトリの名前を指定する null 終端文字列のアドレスです。このメンバーが NULL の場合、カレント ディレクトリが作業ディレクトリとして使用されます。 | ||||||||||||||||||||||||||||||||||||||||||||
| nShow | INT | 4 | +48 | +28 | 必須です。アプリケーションを開いたときにどのように表示するかを指定するフラグで、ShellExecute 関数に列挙されている SW_ 値のいずれかです。lpFile がドキュメント ファイルを指定している場合、このフラグは関連付けられたアプリケーションにそのまま渡されます。これをどう扱うかはアプリケーション次第です。 | ||||||||||||||||||||||||||||||||||||||||||||
| hInstApp | HINSTANCE | 8/4 | +52 | +32 | [out] SEE_MASK_NOCLOSEPROCESS が設定されていて ShellExecuteEx の呼び出しが成功した場合、このメンバーには 32 より大きい値が設定されます。関数が失敗した場合は、失敗の原因を示す SE_ERR_XXX エラー値が設定されます。hInstApp は 16 ビット Windows アプリケーションとの互換性のために HINSTANCE として宣言されていますが、真の HINSTANCE ではありません。int にのみキャストでき、32 または次の SE_ERR_XXX エラー コードとのみ比較できます。
| ||||||||||||||||||||||||||||||||||||||||||||
| lpIDList | void* | 8/4 | +60 | +36 | 実行するファイルを一意に識別するアイテム識別子リストを格納する、絶対 ITEMIDLIST 構造体 (PCIDLIST_ABSOLUTE) のアドレスです。fMask メンバーに SEE_MASK_IDLIST または SEE_MASK_INVOKEIDLIST が含まれていない場合、このメンバーは無視されます。 | ||||||||||||||||||||||||||||||||||||||||||||
| lpClass | LPWSTR | 8/4 | +68 | +40 | 次のいずれかを指定する null 終端文字列のアドレスです:
fMask に SEE_MASK_CLASSNAME が含まれていない場合、このメンバーは無視されます。 | ||||||||||||||||||||||||||||||||||||||||||||
| hkeyClass | HKEY | 8/4 | +76 | +44 | ファイルの種類に対応するレジストリ キーへのハンドルです。このレジストリ キーのアクセス権は KEY_READ に設定してください。fMask に SEE_MASK_CLASSKEY が含まれていない場合、このメンバーは無視されます。 | ||||||||||||||||||||||||||||||||||||||||||||
| dwHotKey | DWORD | 4 | +84 | +48 | アプリケーションに関連付けるキーボード ショートカットです。下位ワードは仮想キー コード、上位ワードは修飾フラグ (HOTKEYF_) です。修飾フラグの一覧については、WM_SETHOTKEY メッセージの説明を参照してください。fMask に SEE_MASK_HOTKEY が含まれていない場合、このメンバーは無視されます。 | ||||||||||||||||||||||||||||||||||||||||||||
| Anonymous | _Anonymous_e__Union | 8/4 | +88 | +52 | hIcon と hMonitor を共用する無名共用体。フラグに応じて使い分ける。 | ||||||||||||||||||||||||||||||||||||||||||||
| hProcess | HANDLE | 8/4 | +96 | +56 | 新しく開始されたアプリケーションへのハンドルです。このメンバーは戻り時に設定され、fMask に SEE_MASK_NOCLOSEPROCESS が設定されていない限り、常に NULL です。fMask に SEE_MASK_NOCLOSEPROCESS が設定されていても、プロセスが起動されなかった場合、hProcess は NULL になります。たとえば、起動するドキュメントが URL であり、Internet Explorer のインスタンスが既に実行されている場合、そのインスタンスがドキュメントを表示します。新しいプロセスは起動されないため、hProcess は NULL になります。 Note: ShellExecuteEx は、呼び出しの結果としてプロセスが起動された場合でも、常に hProcess を返すとは限りません。たとえば、SEE_MASK_INVOKEIDLIST を使用して IContextMenu を呼び出す場合、hProcess は返されません。 |
共用体: _Anonymous_e__Union x64 8B / x86 4B
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| hIcon | HANDLE | 8/4 | +0 | +0 | ファイルの種類に対応するアイコンへのハンドルです。fMask に SEE_MASK_ICON が含まれていない場合、このメンバーは無視されます。この値は Windows XP 以前でのみ使用されます。Windows Vista 以降では無視されます。 |
| hMonitor | HANDLE | 8/4 | +0 | +0 | ドキュメントを表示するモニターへのハンドルです。fMask に SEE_MASK_HMONITOR が含まれていない場合、このメンバーは無視されます。 |
公式ドキュメント
ShellExecuteEx で使用される情報を格納します。
解説(Remarks)
ShellExecuteEx を呼び出すスレッドにメッセージ ループがない場合、またはそのスレッドやプロセスが ShellExecuteEx の戻り後すぐに終了する場合は、SEE_MASK_NOASYNC フラグを指定しなければなりません。このような状況では、呼び出し元スレッドが DDE 会話の完了に利用できないため、ShellExecuteEx が呼び出し元アプリケーションに制御を返す前に会話を完了しておくことが重要です。会話を完了できない場合、ドキュメントの起動に失敗することがあります。
呼び出し元スレッドにメッセージ ループがあり、ShellExecuteEx の呼び出しから戻った後もしばらく存続する場合、SEE_MASK_NOASYNC フラグは省略可能です。このフラグを省略した場合、呼び出し元スレッドのメッセージ ポンプが DDE 会話の完了に使用されます。DDE 会話はバックグラウンドで完了できるため、呼び出し元アプリケーションはより早く制御を取り戻します。
ユーザー操作の結果としてこの API を呼び出す場合は、SEE_MASK_FLAG_LOG_USAGE を指定してください。
lpParameters に二重引用符を含めるには、次の例のように各引用符を引用符のペアで囲みます。
sei.lpParameters = "An example: \"\"\"quoted text\"\"\"";
この場合、アプリケーションは An、example:、"quoted text" という 3 つのパラメーターを受け取ります。
shellapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版と Unicode 版を自動的に選択するエイリアスとして、SHELLEXECUTEINFO を定義しています。エンコーディング中立のエイリアスの使用と、エンコーディング中立でないコードとを混在させると、不一致が生じてコンパイル エラーや実行時エラーの原因となることがあります。詳細については、「Conventions for Function Prototypes」を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// SHELLEXECUTEINFOW (x64 104 / x86 60 バイト)
#pragma pack(push, 1)
typedef struct SHELLEXECUTEINFOW {
DWORD cbSize;
DWORD fMask;
HWND hwnd;
LPWSTR lpVerb;
LPWSTR lpFile;
LPWSTR lpParameters;
LPWSTR lpDirectory;
INT nShow;
HINSTANCE hInstApp;
void* lpIDList;
LPWSTR lpClass;
HKEY hkeyClass;
DWORD dwHotKey;
_Anonymous_e__Union Anonymous;
HANDLE hProcess;
} SHELLEXECUTEINFOW;
#pragma pack(pop)using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct SHELLEXECUTEINFOW
{
public uint cbSize;
public uint fMask;
public IntPtr hwnd;
public IntPtr lpVerb;
public IntPtr lpFile;
public IntPtr lpParameters;
public IntPtr lpDirectory;
public int nShow;
public IntPtr hInstApp;
public IntPtr lpIDList;
public IntPtr lpClass;
public IntPtr hkeyClass;
public uint dwHotKey;
public _Anonymous_e__Union Anonymous;
public IntPtr hProcess;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure SHELLEXECUTEINFOW
Public cbSize As UInteger
Public fMask As UInteger
Public hwnd As IntPtr
Public lpVerb As IntPtr
Public lpFile As IntPtr
Public lpParameters As IntPtr
Public lpDirectory As IntPtr
Public nShow As Integer
Public hInstApp As IntPtr
Public lpIDList As IntPtr
Public lpClass As IntPtr
Public hkeyClass As IntPtr
Public dwHotKey As UInteger
Public Anonymous As _Anonymous_e__Union
Public hProcess As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class SHELLEXECUTEINFOW(ctypes.Structure):
_pack_ = 1
_fields_ = [
("cbSize", wintypes.DWORD),
("fMask", wintypes.DWORD),
("hwnd", ctypes.c_void_p),
("lpVerb", ctypes.c_void_p),
("lpFile", ctypes.c_void_p),
("lpParameters", ctypes.c_void_p),
("lpDirectory", ctypes.c_void_p),
("nShow", ctypes.c_int),
("hInstApp", ctypes.c_void_p),
("lpIDList", ctypes.c_void_p),
("lpClass", ctypes.c_void_p),
("hkeyClass", ctypes.c_void_p),
("dwHotKey", wintypes.DWORD),
("Anonymous", _Anonymous_e__Union),
("hProcess", ctypes.c_void_p),
]#[repr(C, packed(1))]
pub struct SHELLEXECUTEINFOW {
pub cbSize: u32,
pub fMask: u32,
pub hwnd: *mut core::ffi::c_void,
pub lpVerb: *mut core::ffi::c_void,
pub lpFile: *mut core::ffi::c_void,
pub lpParameters: *mut core::ffi::c_void,
pub lpDirectory: *mut core::ffi::c_void,
pub nShow: i32,
pub hInstApp: *mut core::ffi::c_void,
pub lpIDList: *mut core::ffi::c_void,
pub lpClass: *mut core::ffi::c_void,
pub hkeyClass: *mut core::ffi::c_void,
pub dwHotKey: u32,
pub Anonymous: _Anonymous_e__Union,
pub hProcess: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type SHELLEXECUTEINFOW struct {
cbSize uint32
fMask uint32
hwnd uintptr
lpVerb uintptr
lpFile uintptr
lpParameters uintptr
lpDirectory uintptr
nShow int32
hInstApp uintptr
lpIDList uintptr
lpClass uintptr
hkeyClass uintptr
dwHotKey uint32
Anonymous _Anonymous_e__Union
hProcess uintptr
}type
SHELLEXECUTEINFOW = packed record
cbSize: DWORD;
fMask: DWORD;
hwnd: Pointer;
lpVerb: Pointer;
lpFile: Pointer;
lpParameters: Pointer;
lpDirectory: Pointer;
nShow: Integer;
hInstApp: Pointer;
lpIDList: Pointer;
lpClass: Pointer;
hkeyClass: Pointer;
dwHotKey: DWORD;
Anonymous: _Anonymous_e__Union;
hProcess: Pointer;
end;const SHELLEXECUTEINFOW = extern struct {
cbSize: u32,
fMask: u32,
hwnd: ?*anyopaque,
lpVerb: ?*anyopaque,
lpFile: ?*anyopaque,
lpParameters: ?*anyopaque,
lpDirectory: ?*anyopaque,
nShow: i32,
hInstApp: ?*anyopaque,
lpIDList: ?*anyopaque,
lpClass: ?*anyopaque,
hkeyClass: ?*anyopaque,
dwHotKey: u32,
Anonymous: _Anonymous_e__Union,
hProcess: ?*anyopaque,
};type
SHELLEXECUTEINFOW {.packed.} = object
cbSize: uint32
fMask: uint32
hwnd: pointer
lpVerb: pointer
lpFile: pointer
lpParameters: pointer
lpDirectory: pointer
nShow: int32
hInstApp: pointer
lpIDList: pointer
lpClass: pointer
hkeyClass: pointer
dwHotKey: uint32
Anonymous: _Anonymous_e__Union
hProcess: pointeralign(1)
struct SHELLEXECUTEINFOW
{
uint cbSize;
uint fMask;
void* hwnd;
void* lpVerb;
void* lpFile;
void* lpParameters;
void* lpDirectory;
int nShow;
void* hInstApp;
void* lpIDList;
void* lpClass;
void* hkeyClass;
uint dwHotKey;
_Anonymous_e__Union Anonymous;
void* hProcess;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; SHELLEXECUTEINFOW サイズ: 60 バイト(x86)
dim st, 15 ; 4byte整数×15(構造体サイズ 60 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; fMask : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; hwnd : HWND (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; lpVerb : LPWSTR (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; lpFile : LPWSTR (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; lpParameters : LPWSTR (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; lpDirectory : LPWSTR (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; nShow : INT (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; hInstApp : HINSTANCE (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; lpIDList : void* (+36, 4byte) st.9 = 値 / 値 = st.9 (lpoke/lpeek も可)
; lpClass : LPWSTR (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; hkeyClass : HKEY (+44, 4byte) st.11 = 値 / 値 = st.11 (lpoke/lpeek も可)
; dwHotKey : DWORD (+48, 4byte) st.12 = 値 / 値 = st.12 (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+52, 4byte) varptr(st)+52 を基点に操作(4byte:入れ子/配列)
; hProcess : HANDLE (+56, 4byte) st.14 = 値 / 値 = st.14 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SHELLEXECUTEINFOW サイズ: 104 バイト(x64)
dim st, 26 ; 4byte整数×26(構造体サイズ 104 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; fMask : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; hwnd : HWND (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; lpVerb : LPWSTR (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; lpFile : LPWSTR (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; lpParameters : LPWSTR (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; lpDirectory : LPWSTR (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; nShow : INT (+48, 4byte) st.12 = 値 / 値 = st.12 (lpoke/lpeek も可)
; hInstApp : HINSTANCE (+52, 8byte) qpoke st,52,値 / qpeek(st,52) ※IronHSPのみ。3.7/3.8は lpoke st,52,下位 : lpoke st,56,上位
; lpIDList : void* (+60, 8byte) qpoke st,60,値 / qpeek(st,60) ※IronHSPのみ。3.7/3.8は lpoke st,60,下位 : lpoke st,64,上位
; lpClass : LPWSTR (+68, 8byte) qpoke st,68,値 / qpeek(st,68) ※IronHSPのみ。3.7/3.8は lpoke st,68,下位 : lpoke st,72,上位
; hkeyClass : HKEY (+76, 8byte) qpoke st,76,値 / qpeek(st,76) ※IronHSPのみ。3.7/3.8は lpoke st,76,下位 : lpoke st,80,上位
; dwHotKey : DWORD (+84, 4byte) st.21 = 値 / 値 = st.21 (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+88, 8byte) varptr(st)+88 を基点に操作(8byte:入れ子/配列)
; hProcess : HANDLE (+96, 8byte) qpoke st,96,値 / qpeek(st,96) ※IronHSPのみ。3.7/3.8は lpoke st,96,下位 : lpoke st,100,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global SHELLEXECUTEINFOW, pack=1
#field int cbSize
#field int fMask
#field intptr hwnd
#field intptr lpVerb
#field intptr lpFile
#field intptr lpParameters
#field intptr lpDirectory
#field int nShow
#field intptr hInstApp
#field intptr lpIDList
#field intptr lpClass
#field intptr hkeyClass
#field int dwHotKey
#field byte Anonymous 8
#field intptr hProcess
#endstruct
stdim st, SHELLEXECUTEINFOW ; NSTRUCT 変数を確保
st->cbSize = 100
mes "cbSize=" + st->cbSize
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。