Win32 API 日本語リファレンス
ホーム › Networking.WinSock › INTERFACE_INFO

INTERFACE_INFO

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 80 バイト / x86: 76 バイト

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

フィールド

フィールド型サイズx64x86説明
iiFlagsDWORD4+0+0インタフェースの状態や属性を示すフラグである。IFF_UP等。
iiAddresssockaddr_gen24+8+4インタフェースに割り当てられたアドレスである。
iiBroadcastAddresssockaddr_gen24+32+28インタフェースのブロードキャストアドレスである。
iiNetmasksockaddr_gen24+56+52インタフェースのサブネットマスクである。

各言語での定義

#include <windows.h>

// SOCKADDR  (x64 16 / x86 16 バイト)
typedef struct SOCKADDR {
    ADDRESS_FAMILY sa_family;
    CHAR sa_data[14];
} SOCKADDR;

// IN_ADDR  (x64 8 / x86 4 バイト)
typedef struct IN_ADDR {
    _S_un_e__Union S_un;
} IN_ADDR;

// SOCKADDR_IN  (x64 24 / x86 16 バイト)
typedef struct SOCKADDR_IN {
    ADDRESS_FAMILY sin_family;
    WORD sin_port;
    IN_ADDR sin_addr;
    CHAR sin_zero[8];
} SOCKADDR_IN;

// IN6_ADDR  (x64 16 / x86 16 バイト)
typedef struct IN6_ADDR {
    _u_e__Union u;
} IN6_ADDR;

// sockaddr_in6_old  (x64 24 / x86 24 バイト)
typedef struct sockaddr_in6_old {
    SHORT sin6_family;
    WORD sin6_port;
    DWORD sin6_flowinfo;
    IN6_ADDR sin6_addr;
} sockaddr_in6_old;

// sockaddr_gen  (x64 24 / x86 24 バイト)
typedef struct sockaddr_gen {
    SOCKADDR Address;
    SOCKADDR_IN AddressIn;
    sockaddr_in6_old AddressIn6;
} sockaddr_gen;

// INTERFACE_INFO  (x64 80 / x86 76 バイト)
typedef struct INTERFACE_INFO {
    DWORD iiFlags;
    sockaddr_gen iiAddress;
    sockaddr_gen iiBroadcastAddress;
    sockaddr_gen iiNetmask;
} INTERFACE_INFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SOCKADDR
{
    public ushort sa_family;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 14)] public sbyte[] sa_data;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct IN_ADDR
{
    public _S_un_e__Union S_un;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SOCKADDR_IN
{
    public ushort sin_family;
    public ushort sin_port;
    public IN_ADDR sin_addr;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 8)] public sbyte[] sin_zero;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct IN6_ADDR
{
    public _u_e__Union u;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct sockaddr_in6_old
{
    public short sin6_family;
    public ushort sin6_port;
    public uint sin6_flowinfo;
    public IN6_ADDR sin6_addr;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct sockaddr_gen
{
    public SOCKADDR Address;
    public SOCKADDR_IN AddressIn;
    public sockaddr_in6_old AddressIn6;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct INTERFACE_INFO
{
    public uint iiFlags;
    public sockaddr_gen iiAddress;
    public sockaddr_gen iiBroadcastAddress;
    public sockaddr_gen iiNetmask;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SOCKADDR
    Public sa_family As UShort
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=14)> Public sa_data() As SByte
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure IN_ADDR
    Public S_un As _S_un_e__Union
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SOCKADDR_IN
    Public sin_family As UShort
    Public sin_port As UShort
    Public sin_addr As IN_ADDR
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=8)> Public sin_zero() As SByte
End Structure

<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 sockaddr_in6_old
    Public sin6_family As Short
    Public sin6_port As UShort
    Public sin6_flowinfo As UInteger
    Public sin6_addr As IN6_ADDR
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure sockaddr_gen
    Public Address As SOCKADDR
    Public AddressIn As SOCKADDR_IN
    Public AddressIn6 As sockaddr_in6_old
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure INTERFACE_INFO
    Public iiFlags As UInteger
    Public iiAddress As sockaddr_gen
    Public iiBroadcastAddress As sockaddr_gen
    Public iiNetmask As sockaddr_gen
End Structure
import ctypes
from ctypes import wintypes

class SOCKADDR(ctypes.Structure):
    _fields_ = [
        ("sa_family", ctypes.c_ushort),
        ("sa_data", ctypes.c_byte * 14),
    ]

class IN_ADDR(ctypes.Structure):
    _fields_ = [
        ("S_un", _S_un_e__Union),
    ]

class SOCKADDR_IN(ctypes.Structure):
    _fields_ = [
        ("sin_family", ctypes.c_ushort),
        ("sin_port", ctypes.c_ushort),
        ("sin_addr", IN_ADDR),
        ("sin_zero", ctypes.c_byte * 8),
    ]

class IN6_ADDR(ctypes.Structure):
    _fields_ = [
        ("u", _u_e__Union),
    ]

class sockaddr_in6_old(ctypes.Structure):
    _fields_ = [
        ("sin6_family", ctypes.c_short),
        ("sin6_port", ctypes.c_ushort),
        ("sin6_flowinfo", wintypes.DWORD),
        ("sin6_addr", IN6_ADDR),
    ]

class sockaddr_gen(ctypes.Structure):
    _fields_ = [
        ("Address", SOCKADDR),
        ("AddressIn", SOCKADDR_IN),
        ("AddressIn6", sockaddr_in6_old),
    ]

class INTERFACE_INFO(ctypes.Structure):
    _fields_ = [
        ("iiFlags", wintypes.DWORD),
        ("iiAddress", sockaddr_gen),
        ("iiBroadcastAddress", sockaddr_gen),
        ("iiNetmask", sockaddr_gen),
    ]
#[repr(C)]
pub struct SOCKADDR {
    pub sa_family: u16,
    pub sa_data: [i8; 14],
}

#[repr(C)]
pub struct IN_ADDR {
    pub S_un: _S_un_e__Union,
}

#[repr(C)]
pub struct SOCKADDR_IN {
    pub sin_family: u16,
    pub sin_port: u16,
    pub sin_addr: IN_ADDR,
    pub sin_zero: [i8; 8],
}

#[repr(C)]
pub struct IN6_ADDR {
    pub u: _u_e__Union,
}

#[repr(C)]
pub struct sockaddr_in6_old {
    pub sin6_family: i16,
    pub sin6_port: u16,
    pub sin6_flowinfo: u32,
    pub sin6_addr: IN6_ADDR,
}

#[repr(C)]
pub struct sockaddr_gen {
    pub Address: SOCKADDR,
    pub AddressIn: SOCKADDR_IN,
    pub AddressIn6: sockaddr_in6_old,
}

#[repr(C)]
pub struct INTERFACE_INFO {
    pub iiFlags: u32,
    pub iiAddress: sockaddr_gen,
    pub iiBroadcastAddress: sockaddr_gen,
    pub iiNetmask: sockaddr_gen,
}
import "golang.org/x/sys/windows"

type SOCKADDR struct {
	sa_family uint16
	sa_data [14]int8
}

type IN_ADDR struct {
	S_un _S_un_e__Union
}

type SOCKADDR_IN struct {
	sin_family uint16
	sin_port uint16
	sin_addr IN_ADDR
	sin_zero [8]int8
}

type IN6_ADDR struct {
	u _u_e__Union
}

type sockaddr_in6_old struct {
	sin6_family int16
	sin6_port uint16
	sin6_flowinfo uint32
	sin6_addr IN6_ADDR
}

type sockaddr_gen struct {
	Address SOCKADDR
	AddressIn SOCKADDR_IN
	AddressIn6 sockaddr_in6_old
}

type INTERFACE_INFO struct {
	iiFlags uint32
	iiAddress sockaddr_gen
	iiBroadcastAddress sockaddr_gen
	iiNetmask sockaddr_gen
}
type
  SOCKADDR = record
    sa_family: Word;
    sa_data: array[0..13] of Shortint;
  end;

  IN_ADDR = record
    S_un: _S_un_e__Union;
  end;

  SOCKADDR_IN = record
    sin_family: Word;
    sin_port: Word;
    sin_addr: IN_ADDR;
    sin_zero: array[0..7] of Shortint;
  end;

  IN6_ADDR = record
    u: _u_e__Union;
  end;

  sockaddr_in6_old = record
    sin6_family: Smallint;
    sin6_port: Word;
    sin6_flowinfo: DWORD;
    sin6_addr: IN6_ADDR;
  end;

  sockaddr_gen = record
    Address: SOCKADDR;
    AddressIn: SOCKADDR_IN;
    AddressIn6: sockaddr_in6_old;
  end;

  INTERFACE_INFO = record
    iiFlags: DWORD;
    iiAddress: sockaddr_gen;
    iiBroadcastAddress: sockaddr_gen;
    iiNetmask: sockaddr_gen;
  end;
const SOCKADDR = extern struct {
    sa_family: u16,
    sa_data: [14]i8,
};

const IN_ADDR = extern struct {
    S_un: _S_un_e__Union,
};

const SOCKADDR_IN = extern struct {
    sin_family: u16,
    sin_port: u16,
    sin_addr: IN_ADDR,
    sin_zero: [8]i8,
};

const IN6_ADDR = extern struct {
    u: _u_e__Union,
};

const sockaddr_in6_old = extern struct {
    sin6_family: i16,
    sin6_port: u16,
    sin6_flowinfo: u32,
    sin6_addr: IN6_ADDR,
};

const sockaddr_gen = extern struct {
    Address: SOCKADDR,
    AddressIn: SOCKADDR_IN,
    AddressIn6: sockaddr_in6_old,
};

const INTERFACE_INFO = extern struct {
    iiFlags: u32,
    iiAddress: sockaddr_gen,
    iiBroadcastAddress: sockaddr_gen,
    iiNetmask: sockaddr_gen,
};
type
  SOCKADDR {.bycopy.} = object
    sa_family: uint16
    sa_data: array[14, int8]

  IN_ADDR {.bycopy.} = object
    S_un: _S_un_e__Union

  SOCKADDR_IN {.bycopy.} = object
    sin_family: uint16
    sin_port: uint16
    sin_addr: IN_ADDR
    sin_zero: array[8, int8]

  IN6_ADDR {.bycopy.} = object
    u: _u_e__Union

  sockaddr_in6_old {.bycopy.} = object
    sin6_family: int16
    sin6_port: uint16
    sin6_flowinfo: uint32
    sin6_addr: IN6_ADDR

  sockaddr_gen {.bycopy.} = object
    Address: SOCKADDR
    AddressIn: SOCKADDR_IN
    AddressIn6: sockaddr_in6_old

  INTERFACE_INFO {.bycopy.} = object
    iiFlags: uint32
    iiAddress: sockaddr_gen
    iiBroadcastAddress: sockaddr_gen
    iiNetmask: sockaddr_gen
struct SOCKADDR
{
    ushort sa_family;
    byte[14] sa_data;
}

struct IN_ADDR
{
    _S_un_e__Union S_un;
}

struct SOCKADDR_IN
{
    ushort sin_family;
    ushort sin_port;
    IN_ADDR sin_addr;
    byte[8] sin_zero;
}

struct IN6_ADDR
{
    _u_e__Union u;
}

struct sockaddr_in6_old
{
    short sin6_family;
    ushort sin6_port;
    uint sin6_flowinfo;
    IN6_ADDR sin6_addr;
}

struct sockaddr_gen
{
    SOCKADDR Address;
    SOCKADDR_IN AddressIn;
    sockaddr_in6_old AddressIn6;
}

struct INTERFACE_INFO
{
    uint iiFlags;
    sockaddr_gen iiAddress;
    sockaddr_gen iiBroadcastAddress;
    sockaddr_gen iiNetmask;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; INTERFACE_INFO サイズ: 76 バイト(x86)
dim st, 19    ; 4byte整数×19(構造体サイズ 76 / 4 切り上げ)
; iiFlags : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; iiAddress : sockaddr_gen (+4, 24byte)  varptr(st)+4 を基点に操作(24byte:入れ子/配列)
; iiBroadcastAddress : sockaddr_gen (+28, 24byte)  varptr(st)+28 を基点に操作(24byte:入れ子/配列)
; iiNetmask : sockaddr_gen (+52, 24byte)  varptr(st)+52 を基点に操作(24byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; INTERFACE_INFO サイズ: 80 バイト(x64)
dim st, 20    ; 4byte整数×20(構造体サイズ 80 / 4 切り上げ)
; iiFlags : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; iiAddress : sockaddr_gen (+8, 24byte)  varptr(st)+8 を基点に操作(24byte:入れ子/配列)
; iiBroadcastAddress : sockaddr_gen (+32, 24byte)  varptr(st)+32 を基点に操作(24byte:入れ子/配列)
; iiNetmask : sockaddr_gen (+56, 24byte)  varptr(st)+56 を基点に操作(24byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global INTERFACE_INFO
    #field int iiFlags
    #field byte iiAddress 24
    #field byte iiBroadcastAddress 24
    #field byte iiNetmask 24
#endstruct

stdim st, INTERFACE_INFO        ; NSTRUCT 変数を確保
st->iiFlags = 100
mes "iiFlags=" + st->iiFlags
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。