Win32 API 日本語リファレンス
ホーム › System.Diagnostics.Debug › SYMBOL_INFO

SYMBOL_INFO

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 88 バイト / x86: 88 バイト

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

フィールド

フィールド型サイズx64x86説明
SizeOfStructDWORD4+0+0構造体のサイズ (バイト単位)。このメンバーには sizeof(SYMBOL_INFO) を設定しなければなりません。データ全体のサイズは SizeOfStruct + (MaxNameLen - 1) * sizeof(TCHAR) になる点に注意してください。1 を減算するのは、名前の先頭の 1 文字分が構造体のサイズにすでに含まれているためです。
TypeIndexDWORD4+4+4シンボルを記述する型データを識別する一意の値。この値はセッション間で保持されません。
ReservedULONGLONG16+8+8このメンバーはシステムによって予約済みです。
IndexDWORD4+24+24

シンボルの一意の値。シンボルに関連付けられる値は、プロセスを実行するたびに同じであるとは限りません。

PDB シンボルの場合、シンボルのインデックス値は、そのシンボルが列挙されるか、名前またはアドレスによる検索で取得されるまで生成されません。CodeView および COFF のすべてのシンボルのインデックス値は、シンボルの読み込み時に生成されます。

SizeDWORD4+28+28

シンボルのサイズ (バイト単位。シンボルがビットフィールドのメンバーである場合はビット単位)。

この値は、モジュールのシンボルが pdb ファイル由来の場合にのみ意味を持ちます。それ以外の場合、この値は通常 0 であり、無視してください。

ModBaseULONGLONG8+32+32シンボルを含むモジュールのベースアドレス。
FlagsSYMBOL_INFO_FLAGS4+40+40

このメンバーには、次の値の 1 つ以上を指定できます。

Value Meaning
SYMFLAG_CLR_TOKEN
0x00040000
 シンボルは CLR トークンです。
SYMFLAG_CONSTANT
0x00000100
 シンボルは定数です。
SYMFLAG_EXPORT
0x00000200
 シンボルはエクスポートテーブル由来です。
SYMFLAG_FORWARDER
0x00000400
 シンボルはフォワーダーです。
SYMFLAG_FRAMEREL
0x00000020
 オフセットはフレーム相対です。
SYMFLAG_FUNCTION
0x00000800
 シンボルは既知の関数です。
SYMFLAG_ILREL
0x00010000
 シンボルのアドレスは、中間言語ブロックの先頭からの相対オフセットです。これはマネージコードにのみ適用されます。
SYMFLAG_LOCAL
0x00000080
 シンボルはローカル変数です。
SYMFLAG_METADATA
0x00020000
 シンボルはマネージメタデータです。
SYMFLAG_PARAMETER
0x00000040
 シンボルはパラメーターです。
SYMFLAG_REGISTER
0x00000008
 シンボルはレジスターです。Register メンバーが使用されます。
SYMFLAG_REGREL
0x00000010
 オフセットはレジスター相対です。
SYMFLAG_SLOT
0x00008000
 シンボルはマネージコードのスロットです。
SYMFLAG_THUNK
0x00002000
 シンボルはサンクです。
SYMFLAG_TLSREL
0x00004000
 シンボルは TLS データ領域へのオフセットです。
SYMFLAG_VALUEPRESENT
0x00000001
 Value メンバーが使用されます。
SYMFLAG_VIRTUAL
0x00001000
 シンボルは SymAddSymbol 関数によって作成された仮想シンボルです。
ValueULONGLONG8+48+48定数の値。
AddressULONGLONG8+56+56シンボルの開始位置の仮想アドレス。
RegisterDWORD4+64+64レジスター。
ScopeDWORD4+68+68

DIA スコープ。詳細については、Visual Studio のドキュメントの Debug Interface Access SDK を参照してください。(このリソースは一部の言語

および国では利用できない場合があります。)

TagDWORD4+72+72PDB の分類。これらの値は、Dbghelp.h 内の SymTagEnum 列挙型で定義されています。
NameLenDWORD4+76+76名前の長さ (文字単位)。NULL 終端文字は含みません。
MaxNameLenDWORD4+80+80Name バッファーのサイズ (文字単位)。このメンバーが 0 の場合、Name メンバーは使用されません。
NameCHAR1+84+84シンボルの名前。 SymSetOptions 関数で SYMOPT_UNDNAME オプションが使用されている場合、名前は装飾なし (undecorated) になることがあります。

公式ドキュメント

シンボル情報を格納します。

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

各言語での定義

#include <windows.h>

// SYMBOL_INFO  (x64 88 / x86 88 バイト)
typedef struct SYMBOL_INFO {
    DWORD SizeOfStruct;
    DWORD TypeIndex;
    ULONGLONG Reserved[2];
    DWORD Index;
    DWORD Size;
    ULONGLONG ModBase;
    SYMBOL_INFO_FLAGS Flags;
    ULONGLONG Value;
    ULONGLONG Address;
    DWORD Register;
    DWORD Scope;
    DWORD Tag;
    DWORD NameLen;
    DWORD MaxNameLen;
    CHAR Name[1];
} SYMBOL_INFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SYMBOL_INFO
{
    public uint SizeOfStruct;
    public uint TypeIndex;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 2)] public ulong[] Reserved;
    public uint Index;
    public uint Size;
    public ulong ModBase;
    public uint Flags;
    public ulong Value;
    public ulong Address;
    public uint Register;
    public uint Scope;
    public uint Tag;
    public uint NameLen;
    public uint MaxNameLen;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public sbyte[] Name;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SYMBOL_INFO
    Public SizeOfStruct As UInteger
    Public TypeIndex As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=2)> Public Reserved() As ULong
    Public Index As UInteger
    Public Size As UInteger
    Public ModBase As ULong
    Public Flags As UInteger
    Public Value As ULong
    Public Address As ULong
    Public Register As UInteger
    Public Scope As UInteger
    Public Tag As UInteger
    Public NameLen As UInteger
    Public MaxNameLen As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public Name() As SByte
End Structure
import ctypes
from ctypes import wintypes

class SYMBOL_INFO(ctypes.Structure):
    _fields_ = [
        ("SizeOfStruct", wintypes.DWORD),
        ("TypeIndex", wintypes.DWORD),
        ("Reserved", ctypes.c_ulonglong * 2),
        ("Index", wintypes.DWORD),
        ("Size", wintypes.DWORD),
        ("ModBase", ctypes.c_ulonglong),
        ("Flags", wintypes.DWORD),
        ("Value", ctypes.c_ulonglong),
        ("Address", ctypes.c_ulonglong),
        ("Register", wintypes.DWORD),
        ("Scope", wintypes.DWORD),
        ("Tag", wintypes.DWORD),
        ("NameLen", wintypes.DWORD),
        ("MaxNameLen", wintypes.DWORD),
        ("Name", ctypes.c_byte * 1),
    ]
#[repr(C)]
pub struct SYMBOL_INFO {
    pub SizeOfStruct: u32,
    pub TypeIndex: u32,
    pub Reserved: [u64; 2],
    pub Index: u32,
    pub Size: u32,
    pub ModBase: u64,
    pub Flags: u32,
    pub Value: u64,
    pub Address: u64,
    pub Register: u32,
    pub Scope: u32,
    pub Tag: u32,
    pub NameLen: u32,
    pub MaxNameLen: u32,
    pub Name: [i8; 1],
}
import "golang.org/x/sys/windows"

type SYMBOL_INFO struct {
	SizeOfStruct uint32
	TypeIndex uint32
	Reserved [2]uint64
	Index uint32
	Size uint32
	ModBase uint64
	Flags uint32
	Value uint64
	Address uint64
	Register uint32
	Scope uint32
	Tag uint32
	NameLen uint32
	MaxNameLen uint32
	Name [1]int8
}
type
  SYMBOL_INFO = record
    SizeOfStruct: DWORD;
    TypeIndex: DWORD;
    Reserved: array[0..1] of UInt64;
    Index: DWORD;
    Size: DWORD;
    ModBase: UInt64;
    Flags: DWORD;
    Value: UInt64;
    Address: UInt64;
    Register: DWORD;
    Scope: DWORD;
    Tag: DWORD;
    NameLen: DWORD;
    MaxNameLen: DWORD;
    Name: array[0..0] of Shortint;
  end;
const SYMBOL_INFO = extern struct {
    SizeOfStruct: u32,
    TypeIndex: u32,
    Reserved: [2]u64,
    Index: u32,
    Size: u32,
    ModBase: u64,
    Flags: u32,
    Value: u64,
    Address: u64,
    Register: u32,
    Scope: u32,
    Tag: u32,
    NameLen: u32,
    MaxNameLen: u32,
    Name: [1]i8,
};
type
  SYMBOL_INFO {.bycopy.} = object
    SizeOfStruct: uint32
    TypeIndex: uint32
    Reserved: array[2, uint64]
    Index: uint32
    Size: uint32
    ModBase: uint64
    Flags: uint32
    Value: uint64
    Address: uint64
    Register: uint32
    Scope: uint32
    Tag: uint32
    NameLen: uint32
    MaxNameLen: uint32
    Name: array[1, int8]
struct SYMBOL_INFO
{
    uint SizeOfStruct;
    uint TypeIndex;
    ulong[2] Reserved;
    uint Index;
    uint Size;
    ulong ModBase;
    uint Flags;
    ulong Value;
    ulong Address;
    uint Register;
    uint Scope;
    uint Tag;
    uint NameLen;
    uint MaxNameLen;
    byte[1] Name;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SYMBOL_INFO サイズ: 88 バイト(x64)
dim st, 22    ; 4byte整数×22(構造体サイズ 88 / 4 切り上げ)
; SizeOfStruct : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; TypeIndex : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; Reserved : ULONGLONG (+8, 16byte)  varptr(st)+8 を基点に操作(16byte:入れ子/配列)
; Index : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; Size : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; ModBase : ULONGLONG (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; Flags : SYMBOL_INFO_FLAGS (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; Value : ULONGLONG (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; Address : ULONGLONG (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; Register : DWORD (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; Scope : DWORD (+68, 4byte)  st.17 = 値  /  値 = st.17   (lpoke/lpeek も可)
; Tag : DWORD (+72, 4byte)  st.18 = 値  /  値 = st.18   (lpoke/lpeek も可)
; NameLen : DWORD (+76, 4byte)  st.19 = 値  /  値 = st.19   (lpoke/lpeek も可)
; MaxNameLen : DWORD (+80, 4byte)  st.20 = 値  /  値 = st.20   (lpoke/lpeek も可)
; Name : CHAR (+84, 1byte)  varptr(st)+84 を基点に操作(1byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global SYMBOL_INFO
    #field int SizeOfStruct
    #field int TypeIndex
    #field int64 Reserved 2
    #field int Index
    #field int Size
    #field int64 ModBase
    #field int Flags
    #field int64 Value
    #field int64 Address
    #field int Register
    #field int Scope
    #field int Tag
    #field int NameLen
    #field int MaxNameLen
    #field byte Name 1
#endstruct

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