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

MINIDUMP_HANDLE_DESCRIPTOR

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 32 バイト / x86: 32 バイトパッキング4

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

フィールド

フィールド型サイズx64x86説明
HandleULONGLONG8+0+0オペレーティングシステムのハンドル値です。
TypeNameRvaDWORD4+8+8ハンドルのオブジェクトの種類を指定する MINIDUMP_STRING 構造体への RVA です。このメンバーは 0 でもかまいません。
ObjectNameRvaDWORD4+12+12ハンドルのオブジェクト名を指定する MINIDUMP_STRING 構造体への RVA です。このメンバーは 0 でもかまいません。
AttributesDWORD4+16+16このメンバーの意味は、ハンドルの種類とオペレーティングシステムによって異なります。
GrantedAccessDWORD4+20+20このメンバーの意味は、ハンドルの種類とオペレーティングシステムによって異なります。
HandleCountDWORD4+24+24このメンバーの意味は、ハンドルの種類とオペレーティングシステムによって異なります。
PointerCountDWORD4+28+28このメンバーの意味は、ハンドルの種類とオペレーティングシステムによって異なります。

公式ドキュメント

ミニダンプが書き込まれた時点における個々のシステムハンドルの状態を格納します。

解説(Remarks)

ハンドルデータストリーム内の最初の記述子は、ヘッダーである MINIDUMP_HANDLE_DATA_STREAM の後に続きます。

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

各言語での定義

#include <windows.h>

// MINIDUMP_HANDLE_DESCRIPTOR  (x64 32 / x86 32 バイト)
#pragma pack(push, 4)
typedef struct MINIDUMP_HANDLE_DESCRIPTOR {
    ULONGLONG Handle;
    DWORD TypeNameRva;
    DWORD ObjectNameRva;
    DWORD Attributes;
    DWORD GrantedAccess;
    DWORD HandleCount;
    DWORD PointerCount;
} MINIDUMP_HANDLE_DESCRIPTOR;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 4, CharSet = CharSet.Unicode)]
public struct MINIDUMP_HANDLE_DESCRIPTOR
{
    public ulong Handle;
    public uint TypeNameRva;
    public uint ObjectNameRva;
    public uint Attributes;
    public uint GrantedAccess;
    public uint HandleCount;
    public uint PointerCount;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=4, CharSet:=CharSet.Unicode)>
Public Structure MINIDUMP_HANDLE_DESCRIPTOR
    Public Handle As ULong
    Public TypeNameRva As UInteger
    Public ObjectNameRva As UInteger
    Public Attributes As UInteger
    Public GrantedAccess As UInteger
    Public HandleCount As UInteger
    Public PointerCount As UInteger
End Structure
import ctypes
from ctypes import wintypes

class MINIDUMP_HANDLE_DESCRIPTOR(ctypes.Structure):
    _pack_ = 4
    _fields_ = [
        ("Handle", ctypes.c_ulonglong),
        ("TypeNameRva", wintypes.DWORD),
        ("ObjectNameRva", wintypes.DWORD),
        ("Attributes", wintypes.DWORD),
        ("GrantedAccess", wintypes.DWORD),
        ("HandleCount", wintypes.DWORD),
        ("PointerCount", wintypes.DWORD),
    ]
#[repr(C, packed(4))]
pub struct MINIDUMP_HANDLE_DESCRIPTOR {
    pub Handle: u64,
    pub TypeNameRva: u32,
    pub ObjectNameRva: u32,
    pub Attributes: u32,
    pub GrantedAccess: u32,
    pub HandleCount: u32,
    pub PointerCount: u32,
}
import "golang.org/x/sys/windows"

type MINIDUMP_HANDLE_DESCRIPTOR struct {
	Handle uint64
	TypeNameRva uint32
	ObjectNameRva uint32
	Attributes uint32
	GrantedAccess uint32
	HandleCount uint32
	PointerCount uint32
}
type
  MINIDUMP_HANDLE_DESCRIPTOR = packed record
    Handle: UInt64;
    TypeNameRva: DWORD;
    ObjectNameRva: DWORD;
    Attributes: DWORD;
    GrantedAccess: DWORD;
    HandleCount: DWORD;
    PointerCount: DWORD;
  end;
const MINIDUMP_HANDLE_DESCRIPTOR = extern struct {
    Handle: u64,
    TypeNameRva: u32,
    ObjectNameRva: u32,
    Attributes: u32,
    GrantedAccess: u32,
    HandleCount: u32,
    PointerCount: u32,
};
type
  MINIDUMP_HANDLE_DESCRIPTOR {.packed.} = object
    Handle: uint64
    TypeNameRva: uint32
    ObjectNameRva: uint32
    Attributes: uint32
    GrantedAccess: uint32
    HandleCount: uint32
    PointerCount: uint32
align(4)
struct MINIDUMP_HANDLE_DESCRIPTOR
{
    ulong Handle;
    uint TypeNameRva;
    uint ObjectNameRva;
    uint Attributes;
    uint GrantedAccess;
    uint HandleCount;
    uint PointerCount;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MINIDUMP_HANDLE_DESCRIPTOR サイズ: 32 バイト(x64)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; Handle : ULONGLONG (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; TypeNameRva : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; ObjectNameRva : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; Attributes : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; GrantedAccess : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; HandleCount : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; PointerCount : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global MINIDUMP_HANDLE_DESCRIPTOR, pack=4
    #field int64 Handle
    #field int TypeNameRva
    #field int ObjectNameRva
    #field int Attributes
    #field int GrantedAccess
    #field int HandleCount
    #field int PointerCount
#endstruct

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