Win32 API 日本語リファレンス
ホームSystem.ApplicationInstallationAndServicing › PM_STARTAPPBLOB

PM_STARTAPPBLOB

構造体
サイズx64: 80 バイト / x86: 68 バイト

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

フィールド

フィールドサイズx64x86説明
cbSizeDWORD4+0+0この構造体のバイトサイズ。
ProductIDGUID16+4+4対象アプリ製品を識別するGUID。
AppTitleLPWSTR8/4+24+20スタート画面に表示するアプリのタイトル文字列。
IconPathLPWSTR8/4+32+24アプリアイコンのパス文字列。NULL可。
IsUninstallableBOOL4+40+28アンインストール可能かを示す真偽値。
AppInstallTypePM_APPLICATION_INSTALL_TYPE4+44+32アプリのインストール種別を示す列挙値。
InstanceIDGUID16+48+36アプリインスタンスを識別するGUID。
StatePM_APPLICATION_STATE4+64+52アプリの現在状態を示す列挙値。
IsModernBOOL4+68+56モダン(UWP)アプリかを示す真偽値。
IsModernLightUpBOOL4+72+60モダンライトアップ対応かを示す真偽値。
LightUpSupportMaskWORD2+76+64ライトアップ対応機能を示すビットマスク。

各言語での定義

#include <windows.h>

// PM_STARTAPPBLOB  (x64 80 / x86 68 バイト)
typedef struct PM_STARTAPPBLOB {
    DWORD cbSize;
    GUID ProductID;
    LPWSTR AppTitle;
    LPWSTR IconPath;
    BOOL IsUninstallable;
    PM_APPLICATION_INSTALL_TYPE AppInstallType;
    GUID InstanceID;
    PM_APPLICATION_STATE State;
    BOOL IsModern;
    BOOL IsModernLightUp;
    WORD LightUpSupportMask;
} PM_STARTAPPBLOB;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PM_STARTAPPBLOB
{
    public uint cbSize;
    public Guid ProductID;
    public IntPtr AppTitle;
    public IntPtr IconPath;
    [MarshalAs(UnmanagedType.Bool)] public bool IsUninstallable;
    public int AppInstallType;
    public Guid InstanceID;
    public int State;
    [MarshalAs(UnmanagedType.Bool)] public bool IsModern;
    [MarshalAs(UnmanagedType.Bool)] public bool IsModernLightUp;
    public ushort LightUpSupportMask;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PM_STARTAPPBLOB
    Public cbSize As UInteger
    Public ProductID As Guid
    Public AppTitle As IntPtr
    Public IconPath As IntPtr
    <MarshalAs(UnmanagedType.Bool)> Public IsUninstallable As Boolean
    Public AppInstallType As Integer
    Public InstanceID As Guid
    Public State As Integer
    <MarshalAs(UnmanagedType.Bool)> Public IsModern As Boolean
    <MarshalAs(UnmanagedType.Bool)> Public IsModernLightUp As Boolean
    Public LightUpSupportMask As UShort
End Structure
import ctypes
from ctypes import wintypes

class PM_STARTAPPBLOB(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("ProductID", GUID),
        ("AppTitle", ctypes.c_void_p),
        ("IconPath", ctypes.c_void_p),
        ("IsUninstallable", wintypes.BOOL),
        ("AppInstallType", ctypes.c_int),
        ("InstanceID", GUID),
        ("State", ctypes.c_int),
        ("IsModern", wintypes.BOOL),
        ("IsModernLightUp", wintypes.BOOL),
        ("LightUpSupportMask", ctypes.c_ushort),
    ]
#[repr(C)]
pub struct PM_STARTAPPBLOB {
    pub cbSize: u32,
    pub ProductID: GUID,
    pub AppTitle: *mut core::ffi::c_void,
    pub IconPath: *mut core::ffi::c_void,
    pub IsUninstallable: i32,
    pub AppInstallType: i32,
    pub InstanceID: GUID,
    pub State: i32,
    pub IsModern: i32,
    pub IsModernLightUp: i32,
    pub LightUpSupportMask: u16,
}
import "golang.org/x/sys/windows"

type PM_STARTAPPBLOB struct {
	cbSize uint32
	ProductID windows.GUID
	AppTitle uintptr
	IconPath uintptr
	IsUninstallable int32
	AppInstallType int32
	InstanceID windows.GUID
	State int32
	IsModern int32
	IsModernLightUp int32
	LightUpSupportMask uint16
}
type
  PM_STARTAPPBLOB = record
    cbSize: DWORD;
    ProductID: TGUID;
    AppTitle: Pointer;
    IconPath: Pointer;
    IsUninstallable: BOOL;
    AppInstallType: Integer;
    InstanceID: TGUID;
    State: Integer;
    IsModern: BOOL;
    IsModernLightUp: BOOL;
    LightUpSupportMask: Word;
  end;
const PM_STARTAPPBLOB = extern struct {
    cbSize: u32,
    ProductID: GUID,
    AppTitle: ?*anyopaque,
    IconPath: ?*anyopaque,
    IsUninstallable: i32,
    AppInstallType: i32,
    InstanceID: GUID,
    State: i32,
    IsModern: i32,
    IsModernLightUp: i32,
    LightUpSupportMask: u16,
};
type
  PM_STARTAPPBLOB {.bycopy.} = object
    cbSize: uint32
    ProductID: GUID
    AppTitle: pointer
    IconPath: pointer
    IsUninstallable: int32
    AppInstallType: int32
    InstanceID: GUID
    State: int32
    IsModern: int32
    IsModernLightUp: int32
    LightUpSupportMask: uint16
struct PM_STARTAPPBLOB
{
    uint cbSize;
    GUID ProductID;
    void* AppTitle;
    void* IconPath;
    int IsUninstallable;
    int AppInstallType;
    GUID InstanceID;
    int State;
    int IsModern;
    int IsModernLightUp;
    ushort LightUpSupportMask;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; PM_STARTAPPBLOB サイズ: 68 バイト(x86)
dim st, 17    ; 4byte整数×17(構造体サイズ 68 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; ProductID : GUID (+4, 16byte)  varptr(st)+4 を基点に操作(16byte:入れ子/配列)
; AppTitle : LPWSTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; IconPath : LPWSTR (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; IsUninstallable : BOOL (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; AppInstallType : PM_APPLICATION_INSTALL_TYPE (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; InstanceID : GUID (+36, 16byte)  varptr(st)+36 を基点に操作(16byte:入れ子/配列)
; State : PM_APPLICATION_STATE (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; IsModern : BOOL (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; IsModernLightUp : BOOL (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; LightUpSupportMask : WORD (+64, 2byte)  wpoke st,64,値  /  値 = wpeek(st,64)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PM_STARTAPPBLOB サイズ: 80 バイト(x64)
dim st, 20    ; 4byte整数×20(構造体サイズ 80 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; ProductID : GUID (+4, 16byte)  varptr(st)+4 を基点に操作(16byte:入れ子/配列)
; AppTitle : LPWSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; IconPath : LPWSTR (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; IsUninstallable : BOOL (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; AppInstallType : PM_APPLICATION_INSTALL_TYPE (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; InstanceID : GUID (+48, 16byte)  varptr(st)+48 を基点に操作(16byte:入れ子/配列)
; State : PM_APPLICATION_STATE (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; IsModern : BOOL (+68, 4byte)  st.17 = 値  /  値 = st.17   (lpoke/lpeek も可)
; IsModernLightUp : BOOL (+72, 4byte)  st.18 = 値  /  値 = st.18   (lpoke/lpeek も可)
; LightUpSupportMask : WORD (+76, 2byte)  wpoke st,76,値  /  値 = wpeek(st,76)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
    #field int Data1
    #field short Data2
    #field short Data3
    #field byte Data4 8
#endstruct

#defstruct global PM_STARTAPPBLOB
    #field int cbSize
    #field GUID ProductID
    #field intptr AppTitle
    #field intptr IconPath
    #field bool IsUninstallable
    #field int AppInstallType
    #field GUID InstanceID
    #field int State
    #field bool IsModern
    #field bool IsModernLightUp
    #field short LightUpSupportMask
#endstruct

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