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

SHELLEXECUTEINFOA

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

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

フィールド

フィールドサイズx64x86説明
cbSizeDWORD4+0+0必須です。この構造体のサイズをバイト単位で指定します。
fMaskDWORD4+4+4

他の構造体メンバーの内容と有効性を示す、次の値の 1 つ以上の組み合わせです。

SEE_MASK_DEFAULT (0x00000000) 既定値を使用します。
SEE_MASK_CLASSNAME (0x00000001) lpClass メンバーで指定されたクラス名を使用します。SEE_MASK_CLASSKEYSEE_MASK_CLASSNAME の両方が設定されている場合は、クラスキーが使用されます。
SEE_MASK_CLASSKEY (0x00000003) hkeyClass メンバーで指定されたクラスキーを使用します。SEE_MASK_CLASSKEYSEE_MASK_CLASSNAME の両方が設定されている場合は、クラスキーが使用されます。
SEE_MASK_IDLIST (0x00000004) lpIDList メンバーで指定されたアイテム識別子リストを使用します。lpIDList メンバーは ITEMIDLIST 構造体を指していなければなりません。
SEE_MASK_INVOKEIDLIST (0x0000000C) 選択されたアイテムのショートカットメニューハンドラーIContextMenu インターフェイスを使用します。アイテムをファイルシステムのパスで指定する場合は lpFile を、PIDL で指定する場合は lpIDList を使用します。このフラグにより、アプリケーションは ShellExecuteEx を使用して、レジストリに列挙された静的な verb ではなく、ショートカットメニュー拡張の verb を呼び出すことができます。
Note: SEE_MASK_INVOKEIDLISTSEE_MASK_IDLIST を上書きし、暗黙的に含みます。
SEE_MASK_ICON (0x00000010) hIcon メンバーで指定されたアイコンを使用します。このフラグは SEE_MASK_HMONITOR と組み合わせることはできません。
Note: このフラグは Windows XP 以前でのみ使用されます。Windows Vista 以降では無視されます。
SEE_MASK_HOTKEY (0x00000020) dwHotKey メンバーで指定されたキーボードショートカットを使用します。
SEE_MASK_NOCLOSEPROCESS (0x00000040) hProcess メンバーがプロセスのハンドルを受け取ることを示すために使用します。このハンドルは通常、ShellExecuteEx で作成されたプロセスが終了したことをアプリケーションが知るために使用されます。DDE 会話によって実行が処理される場合など、ハンドルが返されないこともあります。呼び出し元のアプリケーションは、不要になったハンドルを閉じる責任があります。
SEE_MASK_CONNECTNETDRV (0x00000080) 共有を検証し、ドライブ文字に接続します。これにより、切断されたネットワークドライブを再接続できます。lpFile メンバーは、ネットワーク上のファイルの UNC パスです。
SEE_MASK_NOASYNC (0x00000100) 実行操作が完了するまで待機してから戻ります。このフラグは、DDE など非同期のアクティブ化が発生する可能性のある形式の ShellExecute を使用し、バックグラウンドスレッドで実行される可能性のあるプロセスを作成する呼び出し元が使用します。(注: 呼び出し元のスレッドモデルが Apartment でない場合、ShellExecuteEx は既定でバックグラウンドスレッドで実行されます。) 既にバックグラウンドスレッドで実行されているプロセスから ShellExecuteEx を呼び出す場合は、常にこのフラグを渡してください。また、ShellExecuteEx の呼び出し直後に終了するアプリケーションも、このフラグを指定してください。

実行操作がバックグラウンドスレッドで行われ、呼び出し元が SEE_MASK_ASYNCOK フラグを指定していない場合、呼び出し元のスレッドは新しいプロセスが開始されるまで待機してから戻ります。これは通常、CreateProcess が呼び出されたか、DDE 通信が完了したか、カスタム実行デリゲートが ShellExecuteEx に完了を通知したことを意味します。SEE_MASK_WAITFORINPUTIDLE フラグが指定されている場合、ShellExecuteExWaitForInputIdle を呼び出し、最大 1 分のタイムアウトで新しいプロセスがアイドル状態になるまで待機してから戻ります。

このフラグが必要になる場合の詳細については、「解説」セクションを参照してください。

SEE_MASK_FLAG_DDEWAIT (0x00000100) SEE_MASK_NOASYNC と同じです。そちらの使用が推奨されます。
SEE_MASK_DOENVSUBST (0x00000200) lpDirectory または lpFile メンバーで指定された文字列に含まれる環境変数を展開します。
SEE_MASK_FLAG_NO_UI (0x00000400) このオプションを指定しない場合に通常表示される、ユーザーインターフェイス (UI) のエラーダイアログを表示しません。セキュリティの確認は対象外で、引き続き表示されます。
SEE_MASK_UNICODE (0x00004000) Unicode アプリケーションであることを示すために、このフラグを使用します。
SEE_MASK_NO_CONSOLE (0x00008000) 新しいプロセスに新しいコンソールを作成させるのではなく、親のコンソールを継承させるために使用します。これは CreateProcessCREATE_NEW_CONSOLE フラグを使用した場合とは逆の動作です。
SEE_MASK_ASYNCOK (0x00100000) 実行をバックグラウンドスレッドで行うことができ、バックグラウンドスレッドの終了を待たずに呼び出しは直ちに戻ります。ただし、場合によっては ShellExecuteEx はこのフラグを無視し、プロセスが終了するまで待機してから戻ります。
SEE_MASK_NOQUERYCLASSSTORE (0x01000000) 使用されません。
SEE_MASK_HMONITOR (0x00200000) マルチモニターシステムでモニターを指定する場合に、このフラグを使用します。モニターは hMonitor メンバーで指定します。このフラグは SEE_MASK_ICON と組み合わせることはできません。
SEE_MASK_NOZONECHECKS (0x00800000) ゾーンチェックを実行しません。このフラグにより、ShellExecuteExIAttachmentExecute によって設定されたゾーンチェックを回避できます。
SEE_MASK_WAITFORINPUTIDLE (0x02000000) 新しいプロセスの作成後、1 分のタイムアウトでプロセスがアイドル状態になるまで待機してから戻ります。詳細については WaitForInputIdle を参照してください。
SEE_MASK_FLAG_LOG_USAGE (0x04000000) ユーザーが開始した起動であることを示し、よく使用されるプログラムの追跡などの動作を有効にします。
SEE_MASK_FLAG_HINST_IS_SITE (0x08000000) hInstApp メンバーは、IServiceProvider を実装するオブジェクトの IUnknown を指定するために使用されます。このオブジェクトはサイトポインターとして使用されます。サイトポインターは、ShellExecute 関数、ハンドラーのバインド処理、および呼び出される verb ハンドラーにサービスを提供するために使用されます。

ICreatingProcess を提供すると、呼び出し元は作成されるプロセスの一部のパラメーターを変更できます。

このフラグは Windows 8 以降でサポートされます。

このオプションを指定した場合、呼び出しは呼び出し元スレッド上で同期的に実行されます。

hwndHWND8/4+8+8省略可能です。オーナーウィンドウへのハンドルです。この関数の実行中にシステムが表示する可能性のある UI の表示と位置指定に使用されます。
lpVerbLPSTR8/4+16+12

実行するアクションを指定する、verb と呼ばれる文字列です。使用できる verb の集合は、対象のファイルやフォルダーによって異なります。一般に、オブジェクトのショートカットメニューから実行できるアクションが、使用可能な verb です。このパラメーターには NULL を指定でき、その場合は既定の verb があればそれが使用されます。既定の verb がない場合は ":::no-loc text="open"::" verb が使用されます。どちらの verb も使用できない場合、システムはレジストリに最初に列挙されている verb を使用します。 特定の verb に限定する理由がない限り、算出された既定値を使用するために NULL を渡してください。これは、たとえば SEE_MASK_FLAG_NO_UI を指定しつつ、アプリがインストールされていない場合に「プログラムから開く」の UI を表示させたい場合など、必要になることがあります。

次の verb がよく使用されます。

  • :::no-loc text="edit":::: エディターを起動し、ドキュメントを編集用に開きます。lpFile がドキュメントファイルでない場合、この関数は失敗します。
  • :::no-loc text="explore":::: lpFile で指定されたフォルダーをエクスプローラーで開きます。
  • :::no-loc text="find":::: 指定されたディレクトリを起点に検索を開始します。
  • :::no-loc text="open":::: lpFile パラメーターで指定されたファイルを開きます。ファイルは実行可能ファイル、ドキュメントファイル、またはフォルダーのいずれでもかまいません。
  • :::no-loc text="openas":::: lpFile パラメーターで指定されたファイルを開くアプリをユーザーが選択できる「プログラムから開く」ダイアログを表示します。
  • :::no-loc text="print":::: lpFile で指定されたドキュメントファイルを印刷します。lpFile がドキュメントファイルでない場合、この関数は失敗します。
  • :::no-loc text="properties":::: ファイルまたはフォルダーのプロパティを表示します。
  • runas: アプリケーションを管理者として起動します。ユーザーアカウント制御 (UAC) により、昇格した状態でアプリケーションを実行することへの同意、またはアプリケーションの実行に使用する管理者アカウントの資格情報の入力が求められます。
lpFileLPSTR8/4+24+16

ShellExecuteExlpVerb パラメーターで指定されたアクションを実行する対象となる、ファイルまたはオブジェクトの名前を指定する、NULL で終わる文字列のアドレスです。ShellExecuteEx 関数がサポートするシステムレジストリの verb には、実行可能ファイルとドキュメントファイルに対する ":::no-loc text="open"::"、および印刷ハンドラーが登録されているドキュメントファイルに対する ":::no-loc text="print"::" があります。他のアプリケーションが、.avi ファイルや .wav ファイルに対する ":::no-loc text="play"::" のように、システムレジストリを通じて独自のシェル verb を追加している場合もあります。シェル名前空間のオブジェクトを指定するには、完全修飾された解析名を渡し、fMask パラメーターに SEE_MASK_INVOKEIDLIST フラグを設定します。

Note: SEE_MASK_INVOKEIDLIST フラグが設定されている場合、アイテムをファイルシステムのパスで指定するには lpFile を、PIDL で指定するには lpIDList を使用できます。lpFilelpIDList のいずれか一方は必ず設定しなければなりません。
Note: 名前にパスが含まれていない場合、カレントディレクトリが使用されます。
lpParametersLPSTR8/4+32+20省略可能です。アプリケーションのパラメーターを含む、NULL で終わる文字列のアドレスです。パラメーターはスペースで区切らなければなりません。lpFile メンバーがドキュメントファイルを指定している場合、lpParametersNULL にしてください。
lpDirectoryLPSTR8/4+40+24省略可能です。作業ディレクトリの名前を指定する、NULL で終わる文字列のアドレスです。このメンバーが NULL の場合、カレントディレクトリが作業ディレクトリとして使用されます。
nShowINT4+48+28必須です。アプリケーションを開いたときの表示方法を指定するフラグで、ShellExecute 関数に列挙されている SW_ 値のいずれかです。lpFile がドキュメントファイルを指定している場合、このフラグは関連付けられたアプリケーションにそのまま渡されます。これをどのように扱うかはアプリケーション側が決定します。
hInstAppHINSTANCE8/4+52+32

[out] SEE_MASK_NOCLOSEPROCESS が設定されており、ShellExecuteEx の呼び出しが成功した場合、このメンバーには 32 より大きい値が設定されます。関数が失敗した場合は、失敗の原因を示す SE_ERR_XXX エラー値が設定されます。hInstApp は 16 ビット Windows アプリケーションとの互換性のために HINSTANCE として宣言されていますが、実際の HINSTANCE ではありません。int にキャストして、32 または次の SE_ERR_XXX エラーコードと比較することしかできません。


Error Code Reason
SE_ERR_FNF (2) ファイルが見つかりません。
SE_ERR_PNF (3) パスが見つかりません。
SE_ERR_ACCESSDENIED (5) アクセスが拒否されました。
SE_ERR_OOM (8) メモリが不足しています。
SE_ERR_DLLNOTFOUND (32) ダイナミックリンクライブラリが見つかりません。
SE_ERR_SHARE (26) 開いているファイルを共有できません。
SE_ERR_ASSOCINCOMPLETE (27) ファイルの関連付け情報が不完全です。
SE_ERR_DDETIMEOUT (28) DDE 操作がタイムアウトしました。
SE_ERR_DDEFAIL (29) DDE 操作が失敗しました。
SE_ERR_DDEBUSY (30) DDE 操作がビジー状態です。
SE_ERR_NOASSOC (31) ファイルの関連付けが利用できません。
lpIDListvoid*8/4+60+36実行するファイルを一意に識別するアイテム識別子リストを格納する、絶対 ITEMIDLIST 構造体 (PCIDLIST_ABSOLUTE) のアドレスです。fMask メンバーに SEE_MASK_IDLIST または SEE_MASK_INVOKEIDLIST が含まれていない場合、このメンバーは無視されます。
lpClassLPSTR8/4+68+40

次のいずれかを指定する、NULL で終わる文字列のアドレスです。

  • ProgID。たとえば "Paint.Picture"。
  • URI プロトコルスキーム。たとえば "http"。
  • ファイル拡張子。たとえば ".txt"。
  • 1 つ以上のシェル verb を含むサブキーを指定する、HKEY_CLASSES_ROOT 配下のレジストリパス。このキーは、shell\verb name のような、シェル verb のレジストリスキーマに従うサブキーを持ちます。

fMaskSEE_MASK_CLASSNAME が含まれていない場合、このメンバーは無視されます。

hkeyClassHKEY8/4+76+44ファイルの種類に対応するレジストリキーへのハンドルです。このレジストリキーのアクセス権は KEY_READ に設定してください。fMaskSEE_MASK_CLASSKEY が含まれていない場合、このメンバーは無視されます。
dwHotKeyDWORD4+84+48アプリケーションに関連付けるキーボードショートカットです。下位ワードは仮想キーコード、上位ワードは修飾フラグ (HOTKEYF_) です。修飾フラグの一覧については、WM_SETHOTKEY メッセージの説明を参照してください。fMaskSEE_MASK_HOTKEY が含まれていない場合、このメンバーは無視されます。
Anonymous_Anonymous_e__Union8/4+88+52hIcon と hMonitor を共用する無名共用体。フラグに応じて使い分ける。
hProcessHANDLE8/4+96+56

新しく開始されたアプリケーションへのハンドルです。このメンバーは戻り時に設定され、fMaskSEE_MASK_NOCLOSEPROCESS が設定されていない限り、常に NULL です。fMaskSEE_MASK_NOCLOSEPROCESS が設定されている場合でも、プロセスが起動されなかったときは hProcessNULL になります。たとえば、起動対象のドキュメントが URL であり、Internet Explorer のインスタンスが既に実行中の場合、そのインスタンスがドキュメントを表示します。新しいプロセスは起動されないため、hProcessNULL になります。

Note: ShellExecuteEx は、呼び出しの結果としてプロセスが起動された場合でも、常に hProcess を返すとは限りません。たとえば、SEE_MASK_INVOKEIDLIST を使用して IContextMenu を呼び出す場合、hProcess は返されません。

共用体: _Anonymous_e__Union x64 8B / x86 4B

フィールドサイズx64x86説明
hIconHANDLE8/4+0+0ファイルの種類に対応するアイコンへのハンドルです。fMaskSEE_MASK_ICON が含まれていない場合、このメンバーは無視されます。この値は Windows XP 以前でのみ使用されます。Windows Vista 以降では無視されます。
hMonitorHANDLE8/4+0+0ドキュメントを表示するモニターへのハンドルです。fMaskSEE_MASK_HMONITOR が含まれていない場合、このメンバーは無視されます。

公式ドキュメント

ShellExecuteEx で使用される情報を格納します。

解説(Remarks)

ShellExecuteEx を呼び出すスレッドがメッセージループを持たない場合、または ShellExecuteEx が戻った直後にそのスレッドやプロセスが終了する場合は、SEE_MASK_NOASYNC フラグを指定しなければなりません。このような状況では、呼び出し元スレッドが DDE 会話を完了させることができないため、ShellExecuteEx が呼び出し元アプリケーションに制御を返す前に会話を完了しておくことが重要です。会話を完了できなかった場合、ドキュメントの起動に失敗することがあります。

呼び出し元スレッドがメッセージループを持ち、ShellExecuteEx の呼び出しから戻った後もしばらく存続する場合、SEE_MASK_NOASYNC フラグは省略可能です。このフラグを省略した場合、DDE 会話の完了には呼び出し元スレッドのメッセージポンプが使用されます。DDE 会話をバックグラウンドで完了できるため、呼び出し元アプリケーションはより早く制御を取り戻します。

lpParameters に二重引用符を含めるには、次の例のように各引用符を引用符のペアで囲みます。

sei.lpParameters = "An example: \"\"\"quoted text\"\"\"";

この場合、アプリケーションは Anexample:"quoted text" という 3 つのパラメーターを受け取ります。

メモ

shellapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして、SHELLEXECUTEINFO を定義しています。エンコーディング中立のエイリアスの使用と、エンコーディング中立でないコードを混在させると、不一致が生じ、コンパイルエラーや実行時エラーの原因となることがあります。詳細については、関数プロトタイプの規則 を参照してください。

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

各言語での定義

#include <windows.h>

// SHELLEXECUTEINFOA  (x64 104 / x86 60 バイト)
#pragma pack(push, 1)
typedef struct SHELLEXECUTEINFOA {
    DWORD cbSize;
    DWORD fMask;
    HWND hwnd;
    LPSTR lpVerb;
    LPSTR lpFile;
    LPSTR lpParameters;
    LPSTR lpDirectory;
    INT nShow;
    HINSTANCE hInstApp;
    void* lpIDList;
    LPSTR lpClass;
    HKEY hkeyClass;
    DWORD dwHotKey;
    _Anonymous_e__Union Anonymous;
    HANDLE hProcess;
} SHELLEXECUTEINFOA;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct SHELLEXECUTEINFOA
{
    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 SHELLEXECUTEINFOA
    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 Structure
import ctypes
from ctypes import wintypes

class SHELLEXECUTEINFOA(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 SHELLEXECUTEINFOA {
    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 SHELLEXECUTEINFOA 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
  SHELLEXECUTEINFOA = 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 SHELLEXECUTEINFOA = 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
  SHELLEXECUTEINFOA {.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: pointer
align(1)
struct SHELLEXECUTEINFOA
{
    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 レイアウト)
; SHELLEXECUTEINFOA サイズ: 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 : LPSTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; lpFile : LPSTR (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; lpParameters : LPSTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; lpDirectory : LPSTR (+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 : LPSTR (+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 レイアウト)
; SHELLEXECUTEINFOA サイズ: 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 : LPSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; lpFile : LPSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; lpParameters : LPSTR (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; lpDirectory : LPSTR (+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 : LPSTR (+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 SHELLEXECUTEINFOA, 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, SHELLEXECUTEINFOA        ; NSTRUCT 変数を確保
st->cbSize = 100
mes "cbSize=" + st->cbSize
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。