Win32 API 日本語リファレンス
ホームNetworkManagement.IpHelper › MIB_TCP6ROW_OWNER_MODULE

MIB_TCP6ROW_OWNER_MODULE

構造体
サイズx64: 192 バイト / x86: 192 バイト

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

フィールド

フィールドサイズx64x86説明
ucLocalAddrBYTE16+0+0ローカルコンピューター上の TCP 接続のローカルエンドポイントの IPv6 アドレスです。値が 0 の場合、リスナーが任意のインターフェイスで接続を受け入れられることを示します。
dwLocalScopeIdDWORD4+16+16ローカル IPv6 アドレスのスコープ ID です (ネットワークバイトオーダー)。
dwLocalPortDWORD4+20+20ローカルコンピューター上の TCP 接続のローカルエンドポイントのポート番号です (ネットワークバイトオーダー)。
ucRemoteAddrBYTE16+24+24リモートコンピューター上の TCP 接続のリモートエンドポイントの IPv6 アドレスです。dwState メンバーが MIB_TCP_STATE_LISTEN の場合、この値には意味がありません。
dwRemoteScopeIdDWORD4+40+40リモート IPv6 アドレスのスコープ ID です (ネットワークバイトオーダー)。
dwRemotePortDWORD4+44+44リモートコンピューター上の TCP 接続のリモートエンドポイントのポート番号です (ネットワークバイトオーダー)。
dwStateDWORD4+48+48

TCP 接続の状態です。このメンバーには、Tcpmib.h ヘッダーファイルで定義されている MIB_TCP_STATE 列挙型の値のいずれかを指定できます。Tcpmib.h ヘッダーファイルは Iprtrmib.h に自動的にインクルードされ、さらに Iprtrmib.hIphlpapi.h ヘッダーファイルに自動的にインクルードされる点に注意してください。Tcpmib.h および Iprtrmib.h ヘッダーファイルを直接使用しないでください。

意味
MIB_TCP_STATE_CLOSED
1
TCP 接続は CLOSED 状態です。これは接続状態がまったく存在しないことを表します。
MIB_TCP_STATE_LISTEN
2
TCP 接続は LISTEN 状態であり、任意のリモート TCP およびポートからの接続要求を待機しています。
MIB_TCP_STATE_SYN_SENT
3
TCP 接続は SYN-SENT 状態であり、接続要求 (SYN パケット) を送信した後、対応する接続要求を待機しています。
MIB_TCP_STATE_SYN_RCVD
4
TCP 接続は SYN-RECEIVED 状態であり、接続要求 (SYN パケット) の受信と送信の両方を行った後、接続要求に対する確認応答を待機しています。
MIB_TCP_STATE_ESTAB
5
TCP 接続は ESTABLISHED 状態であり、接続が開かれていて受信データをユーザーに引き渡せることを表します。これは TCP 接続のデータ転送フェーズにおける通常の状態です。
MIB_TCP_STATE_FIN_WAIT1
6
TCP 接続は FIN-WAIT-1 状態であり、リモート TCP からの接続終了要求、または以前に送信した接続終了要求に対する確認応答を待機しています。
MIB_TCP_STATE_FIN_WAIT2
7
TCP 接続は FIN-WAIT-1 状態であり、リモート TCP からの接続終了要求を待機しています。
MIB_TCP_STATE_CLOSE_WAIT
8
TCP 接続は CLOSE-WAIT 状態であり、ローカルユーザーからの接続終了要求を待機しています。
MIB_TCP_STATE_CLOSING
9
TCP 接続は CLOSING 状態であり、リモート TCP からの接続終了要求に対する確認応答を待機しています。
MIB_TCP_STATE_LAST_ACK
10
TCP 接続は LAST-ACK 状態であり、以前にリモート TCP へ送信した接続終了要求 (リモート TCP の接続終了要求に対する確認応答を含む) に対する確認応答を待機しています。
MIB_TCP_STATE_TIME_WAIT
11
TCP 接続は TIME-WAIT 状態であり、リモート TCP が接続終了要求に対する確認応答を受信したことを確実にするために十分な時間が経過するのを待機しています。
MIB_TCP_STATE_DELETE_TCB
12
TCP 接続は TCB 削除状態です。これは、各 TCP エントリの情報を保持するために使用されるデータ構造である伝送制御ブロック (TCB) が削除されることを表します。
dwOwningPidDWORD4+52+52この TCP 接続に対してコンテキストバインドを発行したローカルプロセスの PID です。
liCreateTimestampLONGLONG8+56+56この TCP 接続を作成したコンテキストバインド操作が行われた日時を示す FILETIME 構造体です。
OwningModuleInfoULONGLONG128+64+64所有者情報を格納する不透明なデータの配列です。

公式ドキュメント

MIB_TCP6ROW_OWNER_MODULE 構造体は、特定のプロセス ID (PID) に関連付けられた IPv6 TCP 接続を、所有者情報とともに記述する情報を格納します。

解説(Remarks)

MIB_TCP6TABLE_OWNER_MODULE 構造体は、TableClass パラメーターに TCP_TABLE_CLASS 列挙型の TCP_TABLE_OWNER_MODULE_LISTENERTCP_TABLE_OWNER_MODULE_CONNECTIONS、または TCP_TABLE_OWNER_MODULE_ALL を指定し、ulAf パラメーターに AF_INET6 を指定して GetExtendedTcpTable を呼び出したときに返されます。MIB_TCP6TABLE_OWNER_MODULE 構造体には、MIB_TCP6ROW_OWNER_MODULE 構造体の配列が含まれます。

dwState メンバーは、TCP 状態遷移図における TCP エントリの状態を示します。TCP 接続はその存続期間中に一連の状態を遷移します。状態は次のとおりです: LISTEN、SYN-SENT、SYN-RECEIVED、ESTABLISHED、FIN-WAIT-1、FIN-WAIT-2、CLOSE-WAIT、CLOSING、LAST-ACK、TIME-WAIT、および仮想的な状態である CLOSED。CLOSED が仮想的な状態であるのは、伝送制御ブロックが存在せず、したがって接続も存在しない状態を表すためです。TCP プロトコルは RFC 793 で規定されています。詳細については、http://www.ietf.org/rfc/rfc793.txt を参照してください。

ucLocalAddr メンバーと ucRemoteAddr メンバーは、ネットワークバイトオーダーの文字配列として格納されます。RtlIpv6AddressToString 関数または RtlIpv6AddressToStringEx 関数を使用すると、Windows Sockets DLL を読み込まずに ucLocalAddr メンバーまたは ucRemoteAddr メンバーの IPv6 アドレスを文字列に変換できます。

dwLocalScopeId メンバーと dwRemoteScopeId メンバーはネットワークバイトオーダーです。dwLocalScopeId メンバーまたは dwRemoteScopeId メンバーを使用するには、Windows Sockets の ntohl 関数や inet_ntoa 関数、または同様の関数が必要になる場合があります。

dwLocalPort メンバーと dwRemotePort メンバーはネットワークバイトオーダーです。dwLocalPort メンバーまたは dwRemotePort メンバーを使用するには、Windows Sockets の ntohs 関数や inet_ntoa 関数、または同様の関数が必要になる場合があります。

Windows Vista 以降向けにリリースされた Microsoft Windows Software Development Kit (SDK) では、ヘッダーファイルの構成が変更されました。この構造体は Iprtrmib.h ヘッダーファイルではなく、Tcpmib.h ヘッダーファイルで定義されています。Tcpmib.h ヘッダーファイルは Iprtrmib.h に自動的にインクルードされ、さらに Iprtrmib.hIphlpapi.h ヘッダーファイルに自動的にインクルードされる点に注意してください。Tcpmib.h および Iprtrmib.h ヘッダーファイルを直接使用しないでください。

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

各言語での定義

#include <windows.h>

// MIB_TCP6ROW_OWNER_MODULE  (x64 192 / x86 192 バイト)
typedef struct MIB_TCP6ROW_OWNER_MODULE {
    BYTE ucLocalAddr[16];
    DWORD dwLocalScopeId;
    DWORD dwLocalPort;
    BYTE ucRemoteAddr[16];
    DWORD dwRemoteScopeId;
    DWORD dwRemotePort;
    DWORD dwState;
    DWORD dwOwningPid;
    LONGLONG liCreateTimestamp;
    ULONGLONG OwningModuleInfo[16];
} MIB_TCP6ROW_OWNER_MODULE;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MIB_TCP6ROW_OWNER_MODULE
{
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 16)] public byte[] ucLocalAddr;
    public uint dwLocalScopeId;
    public uint dwLocalPort;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 16)] public byte[] ucRemoteAddr;
    public uint dwRemoteScopeId;
    public uint dwRemotePort;
    public uint dwState;
    public uint dwOwningPid;
    public long liCreateTimestamp;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 16)] public ulong[] OwningModuleInfo;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MIB_TCP6ROW_OWNER_MODULE
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=16)> Public ucLocalAddr() As Byte
    Public dwLocalScopeId As UInteger
    Public dwLocalPort As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=16)> Public ucRemoteAddr() As Byte
    Public dwRemoteScopeId As UInteger
    Public dwRemotePort As UInteger
    Public dwState As UInteger
    Public dwOwningPid As UInteger
    Public liCreateTimestamp As Long
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=16)> Public OwningModuleInfo() As ULong
End Structure
import ctypes
from ctypes import wintypes

class MIB_TCP6ROW_OWNER_MODULE(ctypes.Structure):
    _fields_ = [
        ("ucLocalAddr", ctypes.c_ubyte * 16),
        ("dwLocalScopeId", wintypes.DWORD),
        ("dwLocalPort", wintypes.DWORD),
        ("ucRemoteAddr", ctypes.c_ubyte * 16),
        ("dwRemoteScopeId", wintypes.DWORD),
        ("dwRemotePort", wintypes.DWORD),
        ("dwState", wintypes.DWORD),
        ("dwOwningPid", wintypes.DWORD),
        ("liCreateTimestamp", ctypes.c_longlong),
        ("OwningModuleInfo", ctypes.c_ulonglong * 16),
    ]
#[repr(C)]
pub struct MIB_TCP6ROW_OWNER_MODULE {
    pub ucLocalAddr: [u8; 16],
    pub dwLocalScopeId: u32,
    pub dwLocalPort: u32,
    pub ucRemoteAddr: [u8; 16],
    pub dwRemoteScopeId: u32,
    pub dwRemotePort: u32,
    pub dwState: u32,
    pub dwOwningPid: u32,
    pub liCreateTimestamp: i64,
    pub OwningModuleInfo: [u64; 16],
}
import "golang.org/x/sys/windows"

type MIB_TCP6ROW_OWNER_MODULE struct {
	ucLocalAddr [16]byte
	dwLocalScopeId uint32
	dwLocalPort uint32
	ucRemoteAddr [16]byte
	dwRemoteScopeId uint32
	dwRemotePort uint32
	dwState uint32
	dwOwningPid uint32
	liCreateTimestamp int64
	OwningModuleInfo [16]uint64
}
type
  MIB_TCP6ROW_OWNER_MODULE = record
    ucLocalAddr: array[0..15] of Byte;
    dwLocalScopeId: DWORD;
    dwLocalPort: DWORD;
    ucRemoteAddr: array[0..15] of Byte;
    dwRemoteScopeId: DWORD;
    dwRemotePort: DWORD;
    dwState: DWORD;
    dwOwningPid: DWORD;
    liCreateTimestamp: Int64;
    OwningModuleInfo: array[0..15] of UInt64;
  end;
const MIB_TCP6ROW_OWNER_MODULE = extern struct {
    ucLocalAddr: [16]u8,
    dwLocalScopeId: u32,
    dwLocalPort: u32,
    ucRemoteAddr: [16]u8,
    dwRemoteScopeId: u32,
    dwRemotePort: u32,
    dwState: u32,
    dwOwningPid: u32,
    liCreateTimestamp: i64,
    OwningModuleInfo: [16]u64,
};
type
  MIB_TCP6ROW_OWNER_MODULE {.bycopy.} = object
    ucLocalAddr: array[16, uint8]
    dwLocalScopeId: uint32
    dwLocalPort: uint32
    ucRemoteAddr: array[16, uint8]
    dwRemoteScopeId: uint32
    dwRemotePort: uint32
    dwState: uint32
    dwOwningPid: uint32
    liCreateTimestamp: int64
    OwningModuleInfo: array[16, uint64]
struct MIB_TCP6ROW_OWNER_MODULE
{
    ubyte[16] ucLocalAddr;
    uint dwLocalScopeId;
    uint dwLocalPort;
    ubyte[16] ucRemoteAddr;
    uint dwRemoteScopeId;
    uint dwRemotePort;
    uint dwState;
    uint dwOwningPid;
    long liCreateTimestamp;
    ulong[16] OwningModuleInfo;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MIB_TCP6ROW_OWNER_MODULE サイズ: 192 バイト(x64)
dim st, 48    ; 4byte整数×48(構造体サイズ 192 / 4 切り上げ)
; ucLocalAddr : BYTE (+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 も可)
; ucRemoteAddr : BYTE (+24, 16byte)  varptr(st)+24 を基点に操作(16byte:入れ子/配列)
; dwRemoteScopeId : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; dwRemotePort : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; dwState : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; dwOwningPid : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; liCreateTimestamp : LONGLONG (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; OwningModuleInfo : ULONGLONG (+64, 128byte)  varptr(st)+64 を基点に操作(128byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global MIB_TCP6ROW_OWNER_MODULE
    #field byte ucLocalAddr 16
    #field int dwLocalScopeId
    #field int dwLocalPort
    #field byte ucRemoteAddr 16
    #field int dwRemoteScopeId
    #field int dwRemotePort
    #field int dwState
    #field int dwOwningPid
    #field int64 liCreateTimestamp
    #field int64 OwningModuleInfo 16
#endstruct

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