ホーム › NetworkManagement.IpHelper › GetRTTAndHopCount
GetRTTAndHopCount
関数指定宛先までの往復時間とホップ数を取得する。
シグネチャ
// IPHLPAPI.dll
#include <windows.h>
BOOL GetRTTAndHopCount(
DWORD DestIpAddress,
DWORD* HopCount,
DWORD MaxHops,
DWORD* RTT
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| DestIpAddress | DWORD | in |
| HopCount | DWORD* | out |
| MaxHops | DWORD | in |
| RTT | DWORD* | out |
戻り値の型: BOOL
各言語での呼び出し定義
// IPHLPAPI.dll
#include <windows.h>
BOOL GetRTTAndHopCount(
DWORD DestIpAddress,
DWORD* HopCount,
DWORD MaxHops,
DWORD* RTT
);[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("IPHLPAPI.dll", SetLastError = true, ExactSpelling = true)]
static extern bool GetRTTAndHopCount(
uint DestIpAddress, // DWORD
out uint HopCount, // DWORD* out
uint MaxHops, // DWORD
out uint RTT // DWORD* out
);<DllImport("IPHLPAPI.dll", SetLastError:=True, ExactSpelling:=True)>
Public Shared Function GetRTTAndHopCount(
DestIpAddress As UInteger, ' DWORD
<Out> ByRef HopCount As UInteger, ' DWORD* out
MaxHops As UInteger, ' DWORD
<Out> ByRef RTT As UInteger ' DWORD* out
) As Boolean
End Function' DestIpAddress : DWORD
' HopCount : DWORD* out
' MaxHops : DWORD
' RTT : DWORD* out
Declare PtrSafe Function GetRTTAndHopCount Lib "iphlpapi" ( _
ByVal DestIpAddress As Long, _
ByRef HopCount As Long, _
ByVal MaxHops As Long, _
ByRef RTT As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
GetRTTAndHopCount = ctypes.windll.iphlpapi.GetRTTAndHopCount
GetRTTAndHopCount.restype = wintypes.BOOL
GetRTTAndHopCount.argtypes = [
wintypes.DWORD, # DestIpAddress : DWORD
ctypes.POINTER(wintypes.DWORD), # HopCount : DWORD* out
wintypes.DWORD, # MaxHops : DWORD
ctypes.POINTER(wintypes.DWORD), # RTT : DWORD* out
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('IPHLPAPI.dll')
GetRTTAndHopCount = Fiddle::Function.new(
lib['GetRTTAndHopCount'],
[
-Fiddle::TYPE_INT, # DestIpAddress : DWORD
Fiddle::TYPE_VOIDP, # HopCount : DWORD* out
-Fiddle::TYPE_INT, # MaxHops : DWORD
Fiddle::TYPE_VOIDP, # RTT : DWORD* out
],
Fiddle::TYPE_INT)#[link(name = "iphlpapi")]
extern "system" {
fn GetRTTAndHopCount(
DestIpAddress: u32, // DWORD
HopCount: *mut u32, // DWORD* out
MaxHops: u32, // DWORD
RTT: *mut u32 // DWORD* out
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("IPHLPAPI.dll", SetLastError = true)]
public static extern bool GetRTTAndHopCount(uint DestIpAddress, out uint HopCount, uint MaxHops, out uint RTT);
"@
$api = Add-Type -MemberDefinition $sig -Name 'IPHLPAPI_GetRTTAndHopCount' -Namespace Win32 -PassThru
# $api::GetRTTAndHopCount(DestIpAddress, HopCount, MaxHops, RTT)#uselib "IPHLPAPI.dll"
#func global GetRTTAndHopCount "GetRTTAndHopCount" sptr, sptr, sptr, sptr
; GetRTTAndHopCount DestIpAddress, varptr(HopCount), MaxHops, varptr(RTT) ; 戻り値は stat
; DestIpAddress : DWORD -> "sptr"
; HopCount : DWORD* out -> "sptr"
; MaxHops : DWORD -> "sptr"
; RTT : DWORD* out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "IPHLPAPI.dll" #cfunc global GetRTTAndHopCount "GetRTTAndHopCount" int, var, int, var ; res = GetRTTAndHopCount(DestIpAddress, HopCount, MaxHops, RTT) ; DestIpAddress : DWORD -> "int" ; HopCount : DWORD* out -> "var" ; MaxHops : DWORD -> "int" ; RTT : DWORD* out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "IPHLPAPI.dll" #cfunc global GetRTTAndHopCount "GetRTTAndHopCount" int, sptr, int, sptr ; res = GetRTTAndHopCount(DestIpAddress, varptr(HopCount), MaxHops, varptr(RTT)) ; DestIpAddress : DWORD -> "int" ; HopCount : DWORD* out -> "sptr" ; MaxHops : DWORD -> "int" ; RTT : DWORD* out -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; BOOL GetRTTAndHopCount(DWORD DestIpAddress, DWORD* HopCount, DWORD MaxHops, DWORD* RTT) #uselib "IPHLPAPI.dll" #cfunc global GetRTTAndHopCount "GetRTTAndHopCount" int, var, int, var ; res = GetRTTAndHopCount(DestIpAddress, HopCount, MaxHops, RTT) ; DestIpAddress : DWORD -> "int" ; HopCount : DWORD* out -> "var" ; MaxHops : DWORD -> "int" ; RTT : DWORD* out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; BOOL GetRTTAndHopCount(DWORD DestIpAddress, DWORD* HopCount, DWORD MaxHops, DWORD* RTT) #uselib "IPHLPAPI.dll" #cfunc global GetRTTAndHopCount "GetRTTAndHopCount" int, intptr, int, intptr ; res = GetRTTAndHopCount(DestIpAddress, varptr(HopCount), MaxHops, varptr(RTT)) ; DestIpAddress : DWORD -> "int" ; HopCount : DWORD* out -> "intptr" ; MaxHops : DWORD -> "int" ; RTT : DWORD* out -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
iphlpapi = windows.NewLazySystemDLL("IPHLPAPI.dll")
procGetRTTAndHopCount = iphlpapi.NewProc("GetRTTAndHopCount")
)
// DestIpAddress (DWORD), HopCount (DWORD* out), MaxHops (DWORD), RTT (DWORD* out)
r1, _, err := procGetRTTAndHopCount.Call(
uintptr(DestIpAddress),
uintptr(HopCount),
uintptr(MaxHops),
uintptr(RTT),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // BOOLfunction GetRTTAndHopCount(
DestIpAddress: DWORD; // DWORD
HopCount: Pointer; // DWORD* out
MaxHops: DWORD; // DWORD
RTT: Pointer // DWORD* out
): BOOL; stdcall;
external 'IPHLPAPI.dll' name 'GetRTTAndHopCount';result := DllCall("IPHLPAPI\GetRTTAndHopCount"
, "UInt", DestIpAddress ; DWORD
, "Ptr", HopCount ; DWORD* out
, "UInt", MaxHops ; DWORD
, "Ptr", RTT ; DWORD* out
, "Int") ; return: BOOL●GetRTTAndHopCount(DestIpAddress, HopCount, MaxHops, RTT) = DLL("IPHLPAPI.dll", "bool GetRTTAndHopCount(dword, void*, dword, void*)")
# 呼び出し: GetRTTAndHopCount(DestIpAddress, HopCount, MaxHops, RTT)
# DestIpAddress : DWORD -> "dword"
# HopCount : DWORD* out -> "void*"
# MaxHops : DWORD -> "dword"
# RTT : DWORD* out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。