ホーム › System.Diagnostics.Debug › SymGetLineFromName
SymGetLineFromName
関数モジュールとファイルの行番号からソース行情報を取得する。
シグネチャ
// dbghelp.dll
#include <windows.h>
BOOL SymGetLineFromName(
HANDLE hProcess,
LPCSTR ModuleName, // optional
LPCSTR FileName, // optional
DWORD dwLineNumber,
INT* plDisplacement,
IMAGEHLP_LINE* Line
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| hProcess | HANDLE | in |
| ModuleName | LPCSTR | inoptional |
| FileName | LPCSTR | inoptional |
| dwLineNumber | DWORD | in |
| plDisplacement | INT* | out |
| Line | IMAGEHLP_LINE* | inout |
戻り値の型: BOOL
各言語での呼び出し定義
// dbghelp.dll
#include <windows.h>
BOOL SymGetLineFromName(
HANDLE hProcess,
LPCSTR ModuleName, // optional
LPCSTR FileName, // optional
DWORD dwLineNumber,
INT* plDisplacement,
IMAGEHLP_LINE* Line
);[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("dbghelp.dll", SetLastError = true, ExactSpelling = true)]
static extern bool SymGetLineFromName(
IntPtr hProcess, // HANDLE
[MarshalAs(UnmanagedType.LPStr)] string ModuleName, // LPCSTR optional
[MarshalAs(UnmanagedType.LPStr)] string FileName, // LPCSTR optional
uint dwLineNumber, // DWORD
out int plDisplacement, // INT* out
IntPtr Line // IMAGEHLP_LINE* in/out
);<DllImport("dbghelp.dll", SetLastError:=True, ExactSpelling:=True)>
Public Shared Function SymGetLineFromName(
hProcess As IntPtr, ' HANDLE
<MarshalAs(UnmanagedType.LPStr)> ModuleName As String, ' LPCSTR optional
<MarshalAs(UnmanagedType.LPStr)> FileName As String, ' LPCSTR optional
dwLineNumber As UInteger, ' DWORD
<Out> ByRef plDisplacement As Integer, ' INT* out
Line As IntPtr ' IMAGEHLP_LINE* in/out
) As Boolean
End Function' hProcess : HANDLE
' ModuleName : LPCSTR optional
' FileName : LPCSTR optional
' dwLineNumber : DWORD
' plDisplacement : INT* out
' Line : IMAGEHLP_LINE* in/out
Declare PtrSafe Function SymGetLineFromName Lib "dbghelp" ( _
ByVal hProcess As LongPtr, _
ByVal ModuleName As String, _
ByVal FileName As String, _
ByVal dwLineNumber As Long, _
ByRef plDisplacement As Long, _
ByVal Line As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
SymGetLineFromName = ctypes.windll.dbghelp.SymGetLineFromName
SymGetLineFromName.restype = wintypes.BOOL
SymGetLineFromName.argtypes = [
wintypes.HANDLE, # hProcess : HANDLE
wintypes.LPCSTR, # ModuleName : LPCSTR optional
wintypes.LPCSTR, # FileName : LPCSTR optional
wintypes.DWORD, # dwLineNumber : DWORD
ctypes.POINTER(ctypes.c_int), # plDisplacement : INT* out
ctypes.c_void_p, # Line : IMAGEHLP_LINE* in/out
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('dbghelp.dll')
SymGetLineFromName = Fiddle::Function.new(
lib['SymGetLineFromName'],
[
Fiddle::TYPE_VOIDP, # hProcess : HANDLE
Fiddle::TYPE_VOIDP, # ModuleName : LPCSTR optional
Fiddle::TYPE_VOIDP, # FileName : LPCSTR optional
-Fiddle::TYPE_INT, # dwLineNumber : DWORD
Fiddle::TYPE_VOIDP, # plDisplacement : INT* out
Fiddle::TYPE_VOIDP, # Line : IMAGEHLP_LINE* in/out
],
Fiddle::TYPE_INT)#[link(name = "dbghelp")]
extern "system" {
fn SymGetLineFromName(
hProcess: *mut core::ffi::c_void, // HANDLE
ModuleName: *const u8, // LPCSTR optional
FileName: *const u8, // LPCSTR optional
dwLineNumber: u32, // DWORD
plDisplacement: *mut i32, // INT* out
Line: *mut IMAGEHLP_LINE // IMAGEHLP_LINE* in/out
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("dbghelp.dll", SetLastError = true)]
public static extern bool SymGetLineFromName(IntPtr hProcess, [MarshalAs(UnmanagedType.LPStr)] string ModuleName, [MarshalAs(UnmanagedType.LPStr)] string FileName, uint dwLineNumber, out int plDisplacement, IntPtr Line);
"@
$api = Add-Type -MemberDefinition $sig -Name 'dbghelp_SymGetLineFromName' -Namespace Win32 -PassThru
# $api::SymGetLineFromName(hProcess, ModuleName, FileName, dwLineNumber, plDisplacement, Line)#uselib "dbghelp.dll"
#func global SymGetLineFromName "SymGetLineFromName" sptr, sptr, sptr, sptr, sptr, sptr
; SymGetLineFromName hProcess, ModuleName, FileName, dwLineNumber, varptr(plDisplacement), varptr(Line) ; 戻り値は stat
; hProcess : HANDLE -> "sptr"
; ModuleName : LPCSTR optional -> "sptr"
; FileName : LPCSTR optional -> "sptr"
; dwLineNumber : DWORD -> "sptr"
; plDisplacement : INT* out -> "sptr"
; Line : IMAGEHLP_LINE* in/out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "dbghelp.dll" #cfunc global SymGetLineFromName "SymGetLineFromName" sptr, str, str, int, var, var ; res = SymGetLineFromName(hProcess, ModuleName, FileName, dwLineNumber, plDisplacement, Line) ; hProcess : HANDLE -> "sptr" ; ModuleName : LPCSTR optional -> "str" ; FileName : LPCSTR optional -> "str" ; dwLineNumber : DWORD -> "int" ; plDisplacement : INT* out -> "var" ; Line : IMAGEHLP_LINE* in/out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "dbghelp.dll" #cfunc global SymGetLineFromName "SymGetLineFromName" sptr, str, str, int, sptr, sptr ; res = SymGetLineFromName(hProcess, ModuleName, FileName, dwLineNumber, varptr(plDisplacement), varptr(Line)) ; hProcess : HANDLE -> "sptr" ; ModuleName : LPCSTR optional -> "str" ; FileName : LPCSTR optional -> "str" ; dwLineNumber : DWORD -> "int" ; plDisplacement : INT* out -> "sptr" ; Line : IMAGEHLP_LINE* in/out -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; BOOL SymGetLineFromName(HANDLE hProcess, LPCSTR ModuleName, LPCSTR FileName, DWORD dwLineNumber, INT* plDisplacement, IMAGEHLP_LINE* Line) #uselib "dbghelp.dll" #cfunc global SymGetLineFromName "SymGetLineFromName" intptr, str, str, int, var, var ; res = SymGetLineFromName(hProcess, ModuleName, FileName, dwLineNumber, plDisplacement, Line) ; hProcess : HANDLE -> "intptr" ; ModuleName : LPCSTR optional -> "str" ; FileName : LPCSTR optional -> "str" ; dwLineNumber : DWORD -> "int" ; plDisplacement : INT* out -> "var" ; Line : IMAGEHLP_LINE* in/out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; BOOL SymGetLineFromName(HANDLE hProcess, LPCSTR ModuleName, LPCSTR FileName, DWORD dwLineNumber, INT* plDisplacement, IMAGEHLP_LINE* Line) #uselib "dbghelp.dll" #cfunc global SymGetLineFromName "SymGetLineFromName" intptr, str, str, int, intptr, intptr ; res = SymGetLineFromName(hProcess, ModuleName, FileName, dwLineNumber, varptr(plDisplacement), varptr(Line)) ; hProcess : HANDLE -> "intptr" ; ModuleName : LPCSTR optional -> "str" ; FileName : LPCSTR optional -> "str" ; dwLineNumber : DWORD -> "int" ; plDisplacement : INT* out -> "intptr" ; Line : IMAGEHLP_LINE* in/out -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
dbghelp = windows.NewLazySystemDLL("dbghelp.dll")
procSymGetLineFromName = dbghelp.NewProc("SymGetLineFromName")
)
// hProcess (HANDLE), ModuleName (LPCSTR optional), FileName (LPCSTR optional), dwLineNumber (DWORD), plDisplacement (INT* out), Line (IMAGEHLP_LINE* in/out)
r1, _, err := procSymGetLineFromName.Call(
uintptr(hProcess),
uintptr(unsafe.Pointer(windows.BytePtrFromString(ModuleName))),
uintptr(unsafe.Pointer(windows.BytePtrFromString(FileName))),
uintptr(dwLineNumber),
uintptr(plDisplacement),
uintptr(Line),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // BOOLfunction SymGetLineFromName(
hProcess: THandle; // HANDLE
ModuleName: PAnsiChar; // LPCSTR optional
FileName: PAnsiChar; // LPCSTR optional
dwLineNumber: DWORD; // DWORD
plDisplacement: Pointer; // INT* out
Line: Pointer // IMAGEHLP_LINE* in/out
): BOOL; stdcall;
external 'dbghelp.dll' name 'SymGetLineFromName';result := DllCall("dbghelp\SymGetLineFromName"
, "Ptr", hProcess ; HANDLE
, "AStr", ModuleName ; LPCSTR optional
, "AStr", FileName ; LPCSTR optional
, "UInt", dwLineNumber ; DWORD
, "Ptr", plDisplacement ; INT* out
, "Ptr", Line ; IMAGEHLP_LINE* in/out
, "Int") ; return: BOOL●SymGetLineFromName(hProcess, ModuleName, FileName, dwLineNumber, plDisplacement, Line) = DLL("dbghelp.dll", "bool SymGetLineFromName(void*, char*, char*, dword, void*, void*)")
# 呼び出し: SymGetLineFromName(hProcess, ModuleName, FileName, dwLineNumber, plDisplacement, Line)
# hProcess : HANDLE -> "void*"
# ModuleName : LPCSTR optional -> "char*"
# FileName : LPCSTR optional -> "char*"
# dwLineNumber : DWORD -> "dword"
# plDisplacement : INT* out -> "void*"
# Line : IMAGEHLP_LINE* in/out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。