FILEMUIINFO

構造体

サイズx64: 80 バイト / x86: 80 バイト

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

フィールド

フィールド	型	サイズ	x64	x86	説明
dwSize	DWORD	4	+0	+0	構造体のサイズ。宣言されている 8 バイトを超えて拡張できるバッファーを含みます。指定できる最小値は `sizeof(FILEMUIINFO)` です。
dwVersion	DWORD	4	+4	+4	構造体のバージョン。現在のバージョンは 0x001 です。
dwFileType	DWORD	4	+8	+8	ファイルの種類。指定できる値は次のとおりです。 MUI_FILETYPE_NOT_LANGUAGE_NEUTRAL。入力ファイルにリソース構成データがありません。このファイルの種類は、古い実行可能ファイルによく見られます。この種類が指定されている場合、他のファイルの種類は有用な情報を提供しません。 MUI_FILETYPE_LANGUAGE_NEUTRAL_MAIN。入力ファイルは LN ファイルです。 MUI_FILETYPE_LANGUAGE_NEUTRAL_MUI。入力ファイルは言語固有のリソースファイルです。
pChecksum	BYTE	16	+12	+12	ファイルが LN ファイルまたは言語固有のリソースファイルである場合の、そのファイルの 128 ビットチェックサムへのポインター。
pServiceChecksum	BYTE	16	+28	+28	保守 (サービス) 用に使用される、ファイルの 128 ビットチェックサムへのポインター。
dwLanguageNameOffset	DWORD	4	+44	+44	構造体の先頭から、言語固有のリソースファイルの場合は言語名文字列まで、LN ファイルの場合は最終フォールバック言語名文字列までの、バイト単位のオフセット。
dwTypeIDMainSize	DWORD	4	+48	+48	dwTypeIDMainOffset でオフセットが示される配列のサイズ。このサイズは、dwTypeNameMainOffset で示されるマルチ文字列配列内の文字列数にも対応します。
dwTypeIDMainOffset	DWORD	4	+52	+52	構造体の先頭から、LN ファイルに含まれるリソースの種類を列挙する DWORD 配列までの、バイト単位のオフセット。
dwTypeNameMainOffset	DWORD	4	+56	+56	構造体の先頭から、LN ファイルに含まれるリソース名を列挙するマルチ文字列配列内の一連の null 終端文字列までの、バイト単位のオフセット。
dwTypeIDMUISize	DWORD	4	+60	+60	dwTypeIDMUIOffset でオフセットが示される配列のサイズ。このサイズは、dwTypeNameMUIOffset で示される一連の文字列の数にも対応します。
dwTypeIDMUIOffset	DWORD	4	+64	+64	構造体の先頭から、LN ファイルに含まれるリソースの種類を列挙する DWORD 配列までの、バイト単位のオフセット。
dwTypeNameMUIOffset	DWORD	4	+68	+68	構造体の先頭から、LN ファイルに含まれるリソース名を列挙するマルチ文字列配列までの、バイト単位のオフセット。
abBuffer	BYTE	8	+72	+72	この構造体に割り当てられたメモリの残りの部分。この配列の正しい使用方法については、「解説」セクションを参照してください。

公式ドキュメント

MUI での使用に関連する、ファイルの情報を格納します。このデータのほとんどは、対象ファイルのリソース構成データに格納されています。この構造体が GetFileMUIInfo によって取得されるとき、すべてのフィールドが必ずしも設定されるわけではありません。使用されるフィールドは、アプリケーションがその関数に渡したフラグによって異なります。

メモ MUI アプリケーションでは、MUI マクロを使用してこの構造体にアクセスできます。

解説(Remarks)

すべてのオフセットは構造体の先頭を基準とした値です。オフセットが 0 の場合は、そのデータが利用できないことを示します。

次の例は、オフセットで示される構造体内の位置にあるデータにアクセスする方法を示しています。この例では、dwLanguageNameOffset で位置が定義されている言語名文字列にアクセスします。

PFILEMUIINFO pFileMUIInfo = NULL;

Allocate_pFileMUIInfo_AndPassTo_GetFileMUIInfo(&pFileMUIInfo);

LPWSTR lpszLang = reinterpret_cast<LPWSTR>(reinterpret_cast<BYTE*>(pFileMUIInfo) + pFileMUIInfo->dwLanguageNameOffset);

この例では 2 つの reinterpret キャストを使用しています。まず、オフセットのポインター演算がバイト単位で行われるように BYTE* へキャストします。次に、得られたポインターを目的の型へキャストします。

また、次のように記述することもできます。効果は同じであり、どちらを選ぶかは単にスタイルの問題です。

PFILEMUIINFO pFileMUIInfo = NULL;

Allocate_pFileMUIInfo_AndPassTo_GetFileMUIInfo(&pFileMUIInfo);

DWORD ix = pFileMUIInfo->dwLanguageNameOffset - offsetof(struct _FILEMUIINFO, abBuffer);
LPWSTR lpszLang = reinterpret_cast<LPWSTR>(&(pFileMUIInfo->abBuffer[ix]));

C# シグネチャ

unsafe public struct FILEMUIINFO
        {
            public System.UInt32 dwSize;
            public System.UInt32 dwVersion;
            public System.UInt32 dwFileType;
            public fixed System.Byte pChecksum[16];
            public fixed System.Byte pServiceChecksum[16];
            public System.UInt32 dwLanguageNameOffset;
            public System.UInt32 dwTypeIDMainSize;
            public System.UInt32 dwTypeIDMainOffset;
            public System.UInt32 dwTypeNameMainOffset;
            public System.UInt32 dwTypeIDMUISize;
            public System.UInt32 dwTypeIDMUIOffset;
            public System.UInt32 dwTypeNameMUIOffset;
            public fixed System.Byte abBuffer[8];
        }

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

各言語での定義

#include <windows.h>

// FILEMUIINFO  (x64 80 / x86 80 バイト)
typedef struct FILEMUIINFO {
    DWORD dwSize;
    DWORD dwVersion;
    DWORD dwFileType;
    BYTE pChecksum[16];
    BYTE pServiceChecksum[16];
    DWORD dwLanguageNameOffset;
    DWORD dwTypeIDMainSize;
    DWORD dwTypeIDMainOffset;
    DWORD dwTypeNameMainOffset;
    DWORD dwTypeIDMUISize;
    DWORD dwTypeIDMUIOffset;
    DWORD dwTypeNameMUIOffset;
    BYTE abBuffer[8];
} FILEMUIINFO;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FILEMUIINFO
{
    public uint dwSize;
    public uint dwVersion;
    public uint dwFileType;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 16)] public byte[] pChecksum;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 16)] public byte[] pServiceChecksum;
    public uint dwLanguageNameOffset;
    public uint dwTypeIDMainSize;
    public uint dwTypeIDMainOffset;
    public uint dwTypeNameMainOffset;
    public uint dwTypeIDMUISize;
    public uint dwTypeIDMUIOffset;
    public uint dwTypeNameMUIOffset;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 8)] public byte[] abBuffer;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FILEMUIINFO
    Public dwSize As UInteger
    Public dwVersion As UInteger
    Public dwFileType As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=16)> Public pChecksum() As Byte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=16)> Public pServiceChecksum() As Byte
    Public dwLanguageNameOffset As UInteger
    Public dwTypeIDMainSize As UInteger
    Public dwTypeIDMainOffset As UInteger
    Public dwTypeNameMainOffset As UInteger
    Public dwTypeIDMUISize As UInteger
    Public dwTypeIDMUIOffset As UInteger
    Public dwTypeNameMUIOffset As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=8)> Public abBuffer() As Byte
End Structure

import ctypes
from ctypes import wintypes

class FILEMUIINFO(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("dwVersion", wintypes.DWORD),
        ("dwFileType", wintypes.DWORD),
        ("pChecksum", ctypes.c_ubyte * 16),
        ("pServiceChecksum", ctypes.c_ubyte * 16),
        ("dwLanguageNameOffset", wintypes.DWORD),
        ("dwTypeIDMainSize", wintypes.DWORD),
        ("dwTypeIDMainOffset", wintypes.DWORD),
        ("dwTypeNameMainOffset", wintypes.DWORD),
        ("dwTypeIDMUISize", wintypes.DWORD),
        ("dwTypeIDMUIOffset", wintypes.DWORD),
        ("dwTypeNameMUIOffset", wintypes.DWORD),
        ("abBuffer", ctypes.c_ubyte * 8),
    ]

#[repr(C)]
pub struct FILEMUIINFO {
    pub dwSize: u32,
    pub dwVersion: u32,
    pub dwFileType: u32,
    pub pChecksum: [u8; 16],
    pub pServiceChecksum: [u8; 16],
    pub dwLanguageNameOffset: u32,
    pub dwTypeIDMainSize: u32,
    pub dwTypeIDMainOffset: u32,
    pub dwTypeNameMainOffset: u32,
    pub dwTypeIDMUISize: u32,
    pub dwTypeIDMUIOffset: u32,
    pub dwTypeNameMUIOffset: u32,
    pub abBuffer: [u8; 8],
}

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

type FILEMUIINFO struct {
	dwSize uint32
	dwVersion uint32
	dwFileType uint32
	pChecksum [16]byte
	pServiceChecksum [16]byte
	dwLanguageNameOffset uint32
	dwTypeIDMainSize uint32
	dwTypeIDMainOffset uint32
	dwTypeNameMainOffset uint32
	dwTypeIDMUISize uint32
	dwTypeIDMUIOffset uint32
	dwTypeNameMUIOffset uint32
	abBuffer [8]byte
}

type
  FILEMUIINFO = record
    dwSize: DWORD;
    dwVersion: DWORD;
    dwFileType: DWORD;
    pChecksum: array[0..15] of Byte;
    pServiceChecksum: array[0..15] of Byte;
    dwLanguageNameOffset: DWORD;
    dwTypeIDMainSize: DWORD;
    dwTypeIDMainOffset: DWORD;
    dwTypeNameMainOffset: DWORD;
    dwTypeIDMUISize: DWORD;
    dwTypeIDMUIOffset: DWORD;
    dwTypeNameMUIOffset: DWORD;
    abBuffer: array[0..7] of Byte;
  end;

const FILEMUIINFO = extern struct {
    dwSize: u32,
    dwVersion: u32,
    dwFileType: u32,
    pChecksum: [16]u8,
    pServiceChecksum: [16]u8,
    dwLanguageNameOffset: u32,
    dwTypeIDMainSize: u32,
    dwTypeIDMainOffset: u32,
    dwTypeNameMainOffset: u32,
    dwTypeIDMUISize: u32,
    dwTypeIDMUIOffset: u32,
    dwTypeNameMUIOffset: u32,
    abBuffer: [8]u8,
};

type
  FILEMUIINFO {.bycopy.} = object
    dwSize: uint32
    dwVersion: uint32
    dwFileType: uint32
    pChecksum: array[16, uint8]
    pServiceChecksum: array[16, uint8]
    dwLanguageNameOffset: uint32
    dwTypeIDMainSize: uint32
    dwTypeIDMainOffset: uint32
    dwTypeNameMainOffset: uint32
    dwTypeIDMUISize: uint32
    dwTypeIDMUIOffset: uint32
    dwTypeNameMUIOffset: uint32
    abBuffer: array[8, uint8]

struct FILEMUIINFO
{
    uint dwSize;
    uint dwVersion;
    uint dwFileType;
    ubyte[16] pChecksum;
    ubyte[16] pServiceChecksum;
    uint dwLanguageNameOffset;
    uint dwTypeIDMainSize;
    uint dwTypeIDMainOffset;
    uint dwTypeNameMainOffset;
    uint dwTypeIDMUISize;
    uint dwTypeIDMUIOffset;
    uint dwTypeNameMUIOffset;
    ubyte[8] abBuffer;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; FILEMUIINFO サイズ: 80 バイト(x64)
dim st, 20    ; 4byte整数×20(構造体サイズ 80 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwVersion : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwFileType : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; pChecksum : BYTE (+12, 16byte)  varptr(st)+12 を基点に操作(16byte:入れ子/配列)
; pServiceChecksum : BYTE (+28, 16byte)  varptr(st)+28 を基点に操作(16byte:入れ子/配列)
; dwLanguageNameOffset : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; dwTypeIDMainSize : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; dwTypeIDMainOffset : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; dwTypeNameMainOffset : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; dwTypeIDMUISize : DWORD (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; dwTypeIDMUIOffset : DWORD (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; dwTypeNameMUIOffset : DWORD (+68, 4byte)  st.17 = 値  /  値 = st.17   (lpoke/lpeek も可)
; abBuffer : BYTE (+72, 8byte)  varptr(st)+72 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global FILEMUIINFO
    #field int dwSize
    #field int dwVersion
    #field int dwFileType
    #field byte pChecksum 16
    #field byte pServiceChecksum 16
    #field int dwLanguageNameOffset
    #field int dwTypeIDMainSize
    #field int dwTypeIDMainOffset
    #field int dwTypeNameMainOffset
    #field int dwTypeIDMUISize
    #field int dwTypeIDMUIOffset
    #field int dwTypeNameMUIOffset
    #field byte abBuffer 8
#endstruct

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