MIB_UDP6ROW
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| dwLocalAddr | IN6_ADDR | 16 | +0 | +0 | ローカルコンピューター上の UDP エンドポイントの IPv6 アドレスです。このメンバーは、ネットワークバイトオーダーで文字配列に格納されます。 0 の場合は、その UDP リスナーが、ローカルコンピューターに関連付けられた任意の IP インターフェイス宛てのデータグラムを受け入れることを示します。 |
| dwLocalScopeId | DWORD | 4 | +16 | +16 | ローカルコンピューター上の UDP エンドポイントの IPv6 アドレスのスコープ ID です。このメンバーはネットワークバイトオーダーで格納されます。 |
| dwLocalPort | DWORD | 4 | +20 | +20 | ローカルコンピューター上の UDP エンドポイントのポート番号です。このメンバーはネットワークバイトオーダーで格納されます。 |
公式ドキュメント
MIB_UDP6ROW 構造体は、ローカルコンピューター上の IPv6 用ユーザーデータグラムプロトコル (UDP) リスナーテーブルのエントリを格納します。
解説(Remarks)
MIB_UDP6ROW 構造体は、Windows Vista 以降で定義されています。
GetUdp6Table 関数は、ローカルコンピューター上の IPv6 用 UDP リスナーテーブルを取得し、その情報を MIB_UDP6TABLE 構造体で返します。
MIB_UDP6TABLE 構造体には、MIB_UDP6ROW 構造体の配列が含まれます。
dwLocalAddr メンバーは in6_addr 構造体に格納されます。RtlIpv6AddressToString 関数または RtlIpv6AddressToStringEx 関数を使用すると、Windows Sockets DLL を読み込まずに dwLocalAddr メンバーの IPv6 アドレスを文字列に変換できます。
dwLocalScopeId メンバーと dwLocalPort メンバーはネットワークバイトオーダーです。これらのメンバーを使用するには、Windows Sockets の ntohs 関数や inet_ntoa 関数、またはそれらに相当する関数が必要になる場合があります。
MIB_UDP6TABLE 構造体は、ローカルコンピューター上の IPv6 用 UDP リスナーテーブルを格納します。この名前は、IETF が公開した RFC 2454 におけるこのテーブルの定義に基づいています。詳細については、http://www.ietf.org/rfc/rfc2454.txt を参照してください。このテーブルには、アドレスにバインドされた IPv6 用の UDP エンドポイントが含まれます。なお、アプリケーションは UDP データグラムを送信することだけを目的として UDP ソケットを作成しアドレスにバインドすることがあり、そのソケットで (リスナーとして) パケットを受信する意図がない場合もある点に注意してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// IN6_ADDR (x64 16 / x86 16 バイト)
typedef struct IN6_ADDR {
_u_e__Union u;
} IN6_ADDR;
// MIB_UDP6ROW (x64 24 / x86 24 バイト)
typedef struct MIB_UDP6ROW {
IN6_ADDR dwLocalAddr;
DWORD dwLocalScopeId;
DWORD dwLocalPort;
} MIB_UDP6ROW;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct IN6_ADDR
{
public _u_e__Union u;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MIB_UDP6ROW
{
public IN6_ADDR dwLocalAddr;
public uint dwLocalScopeId;
public uint dwLocalPort;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure IN6_ADDR
Public u As _u_e__Union
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MIB_UDP6ROW
Public dwLocalAddr As IN6_ADDR
Public dwLocalScopeId As UInteger
Public dwLocalPort As UInteger
End Structureimport ctypes
from ctypes import wintypes
class IN6_ADDR(ctypes.Structure):
_fields_ = [
("u", _u_e__Union),
]
class MIB_UDP6ROW(ctypes.Structure):
_fields_ = [
("dwLocalAddr", IN6_ADDR),
("dwLocalScopeId", wintypes.DWORD),
("dwLocalPort", wintypes.DWORD),
]#[repr(C)]
pub struct IN6_ADDR {
pub u: _u_e__Union,
}
#[repr(C)]
pub struct MIB_UDP6ROW {
pub dwLocalAddr: IN6_ADDR,
pub dwLocalScopeId: u32,
pub dwLocalPort: u32,
}import "golang.org/x/sys/windows"
type IN6_ADDR struct {
u _u_e__Union
}
type MIB_UDP6ROW struct {
dwLocalAddr IN6_ADDR
dwLocalScopeId uint32
dwLocalPort uint32
}type
IN6_ADDR = record
u: _u_e__Union;
end;
MIB_UDP6ROW = record
dwLocalAddr: IN6_ADDR;
dwLocalScopeId: DWORD;
dwLocalPort: DWORD;
end;const IN6_ADDR = extern struct {
u: _u_e__Union,
};
const MIB_UDP6ROW = extern struct {
dwLocalAddr: IN6_ADDR,
dwLocalScopeId: u32,
dwLocalPort: u32,
};type
IN6_ADDR {.bycopy.} = object
u: _u_e__Union
MIB_UDP6ROW {.bycopy.} = object
dwLocalAddr: IN6_ADDR
dwLocalScopeId: uint32
dwLocalPort: uint32struct IN6_ADDR
{
_u_e__Union u;
}
struct MIB_UDP6ROW
{
IN6_ADDR dwLocalAddr;
uint dwLocalScopeId;
uint dwLocalPort;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MIB_UDP6ROW サイズ: 24 バイト(x64)
dim st, 6 ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; dwLocalAddr : IN6_ADDR (+0, 16byte) varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; dwLocalScopeId : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; dwLocalPort : DWORD (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global IN6_ADDR
#field byte u 16
#endstruct
#defstruct global MIB_UDP6ROW
#field IN6_ADDR dwLocalAddr
#field int dwLocalScopeId
#field int dwLocalPort
#endstruct
stdim st, MIB_UDP6ROW ; NSTRUCT 変数を確保
st->dwLocalScopeId = 100
mes "dwLocalScopeId=" + st->dwLocalScopeId