ホーム › NetworkManagement.IpHelper › MIB_TCPTABLE2
MIB_TCPTABLE2
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| dwNumEntries | DWORD | 4 | +0 | +0 | テーブル内のエントリ数。 |
| table | MIB_TCPROW2 | 28 | +4 | +4 | MIB_TCPROW2 構造体の配列として実装された TCP 接続テーブルへのポインター。 |
公式ドキュメント
MIB_TCPTABLE2 構造体は、ローカルコンピューター上の IPv4 TCP 接続のテーブルを格納します。
解説(Remarks)
GetTcpTable2 関数は、ローカルコンピューター上の IPv4 TCP 接続テーブルを取得し、その情報を MIB_TCPTABLE2 構造体で返します。MIB_TCPTABLE2 構造体には、MIB_TCPROW2 構造体の配列が含まれます。
MIB_TCPTABLE2 構造体には、dwNumEntries メンバーと table メンバー内の最初の MIB_TCPROW2 配列エントリとの間に、アラインメントのためのパディングが含まれる場合があります。また、table メンバー内の MIB_TCPROW2 配列エントリ間にも、アラインメントのためのパディングが存在する場合があります。MIB_TCPROW2 配列エントリにアクセスする際は、常にパディングが存在し得ることを前提としてください。
例
次の例では、IPv4 の TCP 接続テーブルを MIB_TCPTABLE2 構造体として取得し、MIB_TCPROW2 構造体で表される各接続の状態を出力します。
#include <winsock2.h>
#include <ws2tcpip.h>
#include <iphlpapi.h>
#include <stdio.h>
// Need to link with Iphlpapi.lib and Ws2_32.lib
#pragma comment(lib, "iphlpapi.lib")
#pragma comment(lib, "ws2_32.lib")
#define MALLOC(x) HeapAlloc(GetProcessHeap(), 0, (x))
#define FREE(x) HeapFree(GetProcessHeap(), 0, (x))
/* Note: could also use malloc() and free() */
int main()
{
// Declare and initialize variables
PMIB_TCPTABLE2 pTcpTable;
ULONG ulSize = 0;
DWORD dwRetVal = 0;
char szLocalAddr[128];
char szRemoteAddr[128];
struct in_addr IpAddr;
int i;
pTcpTable = (MIB_TCPTABLE2 *) MALLOC(sizeof (MIB_TCPTABLE2));
if (pTcpTable == NULL) {
printf("Error allocating memory\n");
return 1;
}
ulSize = sizeof (MIB_TCPTABLE);
// Make an initial call to GetTcpTable2 to
// get the necessary size into the ulSize variable
if ((dwRetVal = GetTcpTable2(pTcpTable, &ulSize, TRUE)) ==
ERROR_INSUFFICIENT_BUFFER) {
FREE(pTcpTable);
pTcpTable = (MIB_TCPTABLE2 *) MALLOC(ulSize);
if (pTcpTable == NULL) {
printf("Error allocating memory\n");
return 1;
}
}
// Make a second call to GetTcpTable2 to get
// the actual data we require
if ((dwRetVal = GetTcpTable2(pTcpTable, &ulSize, TRUE)) == NO_ERROR) {
printf("\tNumber of entries: %d\n", (int) pTcpTable->dwNumEntries);
for (i = 0; i < (int) pTcpTable->dwNumEntries; i++) {
printf("\n\tTCP[%d] State: %ld - ", i,
pTcpTable->table[i].dwState);
switch (pTcpTable->table[i].dwState) {
case MIB_TCP_STATE_CLOSED:
printf("CLOSED\n");
break;
case MIB_TCP_STATE_LISTEN:
printf("LISTEN\n");
break;
case MIB_TCP_STATE_SYN_SENT:
printf("SYN-SENT\n");
break;
case MIB_TCP_STATE_SYN_RCVD:
printf("SYN-RECEIVED\n");
break;
case MIB_TCP_STATE_ESTAB:
printf("ESTABLISHED\n");
break;
case MIB_TCP_STATE_FIN_WAIT1:
printf("FIN-WAIT-1\n");
break;
case MIB_TCP_STATE_FIN_WAIT2:
printf("FIN-WAIT-2 \n");
break;
case MIB_TCP_STATE_CLOSE_WAIT:
printf("CLOSE-WAIT\n");
break;
case MIB_TCP_STATE_CLOSING:
printf("CLOSING\n");
break;
case MIB_TCP_STATE_LAST_ACK:
printf("LAST-ACK\n");
break;
case MIB_TCP_STATE_TIME_WAIT:
printf("TIME-WAIT\n");
break;
case MIB_TCP_STATE_DELETE_TCB:
printf("DELETE-TCB\n");
break;
default:
wprintf(L"UNKNOWN dwState value: %d\n", pTcpTable->table[i].dwState);
break;
}
IpAddr.S_un.S_addr = (u_long) pTcpTable->table[i].dwLocalAddr;
strcpy_s(szLocalAddr, sizeof (szLocalAddr), inet_ntoa(IpAddr));
printf("\tTCP[%d] Local Addr: %s\n", i, szLocalAddr);
printf("\tTCP[%d] Local Port: %d \n", i,
ntohs((u_short)pTcpTable->table[i].dwLocalPort));
IpAddr.S_un.S_addr = (u_long) pTcpTable->table[i].dwRemoteAddr;
strcpy_s(szRemoteAddr, sizeof (szRemoteAddr), inet_ntoa(IpAddr));
printf("\tTCP[%d] Remote Addr: %s\n", i, szRemoteAddr);
printf("\tTCP[%d] Remote Port: %d\n", i,
ntohs((u_short)pTcpTable->table[i].dwRemotePort));
printf("\tTCP[%d] Owning PID: %d\n", i, pTcpTable->table[i].dwOwningPid);
printf("\tTCP[%d] Offload State: %ld - ", i,
pTcpTable->table[i].dwOffloadState);
switch (pTcpTable->table[i].dwOffloadState) {
case TcpConnectionOffloadStateInHost:
printf("Owned by the network stack and not offloaded \n");
break;
case TcpConnectionOffloadStateOffloading:
printf("In the process of being offloaded\n");
break;
case TcpConnectionOffloadStateOffloaded:
printf("Offloaded to the network interface control\n");
break;
case TcpConnectionOffloadStateUploading:
printf("In the process of being uploaded back to the network stack \n");
break;
default:
printf("UNKNOWN Offload state value\n");
break;
}
}
} else {
printf("\tGetTcpTable2 failed with %d\n", dwRetVal);
FREE(pTcpTable);
return 1;
}
if (pTcpTable != NULL) {
FREE(pTcpTable);
pTcpTable = NULL;
}
return 0;
}
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// MIB_TCPROW2 (x64 28 / x86 28 バイト)
typedef struct MIB_TCPROW2 {
DWORD dwState;
DWORD dwLocalAddr;
DWORD dwLocalPort;
DWORD dwRemoteAddr;
DWORD dwRemotePort;
DWORD dwOwningPid;
TCP_CONNECTION_OFFLOAD_STATE dwOffloadState;
} MIB_TCPROW2;
// MIB_TCPTABLE2 (x64 32 / x86 32 バイト)
typedef struct MIB_TCPTABLE2 {
DWORD dwNumEntries;
MIB_TCPROW2 table[1];
} MIB_TCPTABLE2;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MIB_TCPROW2
{
public uint dwState;
public uint dwLocalAddr;
public uint dwLocalPort;
public uint dwRemoteAddr;
public uint dwRemotePort;
public uint dwOwningPid;
public int dwOffloadState;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MIB_TCPTABLE2
{
public uint dwNumEntries;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public MIB_TCPROW2[] table;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MIB_TCPROW2
Public dwState As UInteger
Public dwLocalAddr As UInteger
Public dwLocalPort As UInteger
Public dwRemoteAddr As UInteger
Public dwRemotePort As UInteger
Public dwOwningPid As UInteger
Public dwOffloadState As Integer
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MIB_TCPTABLE2
Public dwNumEntries As UInteger
<MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public table() As MIB_TCPROW2
End Structureimport ctypes
from ctypes import wintypes
class MIB_TCPROW2(ctypes.Structure):
_fields_ = [
("dwState", wintypes.DWORD),
("dwLocalAddr", wintypes.DWORD),
("dwLocalPort", wintypes.DWORD),
("dwRemoteAddr", wintypes.DWORD),
("dwRemotePort", wintypes.DWORD),
("dwOwningPid", wintypes.DWORD),
("dwOffloadState", ctypes.c_int),
]
class MIB_TCPTABLE2(ctypes.Structure):
_fields_ = [
("dwNumEntries", wintypes.DWORD),
("table", MIB_TCPROW2 * 1),
]#[repr(C)]
pub struct MIB_TCPROW2 {
pub dwState: u32,
pub dwLocalAddr: u32,
pub dwLocalPort: u32,
pub dwRemoteAddr: u32,
pub dwRemotePort: u32,
pub dwOwningPid: u32,
pub dwOffloadState: i32,
}
#[repr(C)]
pub struct MIB_TCPTABLE2 {
pub dwNumEntries: u32,
pub table: [MIB_TCPROW2; 1],
}import "golang.org/x/sys/windows"
type MIB_TCPROW2 struct {
dwState uint32
dwLocalAddr uint32
dwLocalPort uint32
dwRemoteAddr uint32
dwRemotePort uint32
dwOwningPid uint32
dwOffloadState int32
}
type MIB_TCPTABLE2 struct {
dwNumEntries uint32
table [1]MIB_TCPROW2
}type
MIB_TCPROW2 = record
dwState: DWORD;
dwLocalAddr: DWORD;
dwLocalPort: DWORD;
dwRemoteAddr: DWORD;
dwRemotePort: DWORD;
dwOwningPid: DWORD;
dwOffloadState: Integer;
end;
MIB_TCPTABLE2 = record
dwNumEntries: DWORD;
table: array[0..0] of MIB_TCPROW2;
end;const MIB_TCPROW2 = extern struct {
dwState: u32,
dwLocalAddr: u32,
dwLocalPort: u32,
dwRemoteAddr: u32,
dwRemotePort: u32,
dwOwningPid: u32,
dwOffloadState: i32,
};
const MIB_TCPTABLE2 = extern struct {
dwNumEntries: u32,
table: [1]MIB_TCPROW2,
};type
MIB_TCPROW2 {.bycopy.} = object
dwState: uint32
dwLocalAddr: uint32
dwLocalPort: uint32
dwRemoteAddr: uint32
dwRemotePort: uint32
dwOwningPid: uint32
dwOffloadState: int32
MIB_TCPTABLE2 {.bycopy.} = object
dwNumEntries: uint32
table: array[1, MIB_TCPROW2]struct MIB_TCPROW2
{
uint dwState;
uint dwLocalAddr;
uint dwLocalPort;
uint dwRemoteAddr;
uint dwRemotePort;
uint dwOwningPid;
int dwOffloadState;
}
struct MIB_TCPTABLE2
{
uint dwNumEntries;
MIB_TCPROW2[1] table;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MIB_TCPTABLE2 サイズ: 32 バイト(x64)
dim st, 8 ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; dwNumEntries : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; table : MIB_TCPROW2 (+4, 28byte) varptr(st)+4 を基点に操作(28byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global MIB_TCPROW2
#field int dwState
#field int dwLocalAddr
#field int dwLocalPort
#field int dwRemoteAddr
#field int dwRemotePort
#field int dwOwningPid
#field int dwOffloadState
#endstruct
#defstruct global MIB_TCPTABLE2
#field int dwNumEntries
#field MIB_TCPROW2 table 1
#endstruct
stdim st, MIB_TCPTABLE2 ; NSTRUCT 変数を確保
st->dwNumEntries = 100
mes "dwNumEntries=" + st->dwNumEntries