ホーム › System.Diagnostics.Debug › RtlUnwind

RtlUnwind

関数

指定フレームまで例外処理のスタック巻き戻しを実行する。

DLLKERNEL32.dll呼出規約winapi対応OSWindows XP 以降

シグネチャ

// KERNEL32.dll
#include <windows.h>

void RtlUnwind(
    void* TargetFrame,   // optional
    void* TargetIp,   // optional
    EXCEPTION_RECORD* ExceptionRecord,   // optional
    void* ReturnValue
);

パラメーター

名前	型	方向	説明
TargetFrame	void*	inoptional	アンワインドの対象となる呼び出しフレームへのポインター。このパラメーターが `NULL` の場合、関数は終了アンワインドを実行します。
TargetIp	void*	inoptional	アンワインドの継続アドレス。TargetFrame が `NULL` の場合、このパラメーターは無視されます。
ExceptionRecord	EXCEPTION_RECORD*	inoptional	EXCEPTION_RECORD 構造体へのポインター。
ReturnValue	void*	in	実行を継続する前に整数関数の戻り値レジスタに設定される値。

戻り値の型: void

公式ドキュメント

プロシージャ呼び出しフレームのアンワインドを開始します。(RtlUnwind)

戻り値

この関数は値を返しません。

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

各言語での呼び出し定義

// KERNEL32.dll
#include <windows.h>

void RtlUnwind(
    void* TargetFrame,   // optional
    void* TargetIp,   // optional
    EXCEPTION_RECORD* ExceptionRecord,   // optional
    void* ReturnValue
);

[DllImport("KERNEL32.dll", ExactSpelling = true)]
static extern void RtlUnwind(
    IntPtr TargetFrame,   // void* optional
    IntPtr TargetIp,   // void* optional
    IntPtr ExceptionRecord,   // EXCEPTION_RECORD* optional
    IntPtr ReturnValue   // void*
);

<DllImport("KERNEL32.dll", ExactSpelling:=True)>
Public Shared Sub RtlUnwind(
    TargetFrame As IntPtr,   ' void* optional
    TargetIp As IntPtr,   ' void* optional
    ExceptionRecord As IntPtr,   ' EXCEPTION_RECORD* optional
    ReturnValue As IntPtr   ' void*
)
End Sub

' TargetFrame : void* optional
' TargetIp : void* optional
' ExceptionRecord : EXCEPTION_RECORD* optional
' ReturnValue : void*
Declare PtrSafe Sub RtlUnwind Lib "kernel32" ( _
    ByVal TargetFrame As LongPtr, _
    ByVal TargetIp As LongPtr, _
    ByVal ExceptionRecord As LongPtr, _
    ByVal ReturnValue As LongPtr)
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

RtlUnwind = ctypes.windll.kernel32.RtlUnwind
RtlUnwind.restype = None
RtlUnwind.argtypes = [
    ctypes.POINTER(None),  # TargetFrame : void* optional
    ctypes.POINTER(None),  # TargetIp : void* optional
    ctypes.c_void_p,  # ExceptionRecord : EXCEPTION_RECORD* optional
    ctypes.POINTER(None),  # ReturnValue : void*
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('KERNEL32.dll')
RtlUnwind = Fiddle::Function.new(
  lib['RtlUnwind'],
  [
    Fiddle::TYPE_VOIDP,  # TargetFrame : void* optional
    Fiddle::TYPE_VOIDP,  # TargetIp : void* optional
    Fiddle::TYPE_VOIDP,  # ExceptionRecord : EXCEPTION_RECORD* optional
    Fiddle::TYPE_VOIDP,  # ReturnValue : void*
  ],
  Fiddle::TYPE_VOID)

#[link(name = "kernel32")]
extern "system" {
    fn RtlUnwind(
        TargetFrame: *mut (),  // void* optional
        TargetIp: *mut (),  // void* optional
        ExceptionRecord: *mut EXCEPTION_RECORD,  // EXCEPTION_RECORD* optional
        ReturnValue: *mut ()  // void*
    );
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("KERNEL32.dll")]
public static extern void RtlUnwind(IntPtr TargetFrame, IntPtr TargetIp, IntPtr ExceptionRecord, IntPtr ReturnValue);
"@
$api = Add-Type -MemberDefinition $sig -Name 'KERNEL32_RtlUnwind' -Namespace Win32 -PassThru
# $api::RtlUnwind(TargetFrame, TargetIp, ExceptionRecord, ReturnValue)

#uselib "KERNEL32.dll"
#func global RtlUnwind "RtlUnwind" sptr, sptr, sptr, sptr
; RtlUnwind TargetFrame, TargetIp, varptr(ExceptionRecord), ReturnValue
; TargetFrame : void* optional -> "sptr"
; TargetIp : void* optional -> "sptr"
; ExceptionRecord : EXCEPTION_RECORD* optional -> "sptr"
; ReturnValue : void* -> "sptr"

出力引数:

#uselib "KERNEL32.dll"
#func global RtlUnwind "RtlUnwind" sptr, sptr, var, sptr
; RtlUnwind TargetFrame, TargetIp, ExceptionRecord, ReturnValue
; TargetFrame : void* optional -> "sptr"
; TargetIp : void* optional -> "sptr"
; ExceptionRecord : EXCEPTION_RECORD* optional -> "var"
; ReturnValue : void* -> "sptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "KERNEL32.dll"
#func global RtlUnwind "RtlUnwind" sptr, sptr, sptr, sptr
; RtlUnwind TargetFrame, TargetIp, varptr(ExceptionRecord), ReturnValue
; TargetFrame : void* optional -> "sptr"
; TargetIp : void* optional -> "sptr"
; ExceptionRecord : EXCEPTION_RECORD* optional -> "sptr"
; ReturnValue : void* -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。