SOCKADDR_INET
共用体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Ipv4 | SOCKADDR_IN | 24/16 | +0 | +0 | アドレスファミリーと IPv4 アドレスを格納する SOCKADDR_IN 構造体として表される IPv4 アドレスです。アドレスファミリーはホストバイトオーダー、IPv4 アドレスはネットワークバイトオーダーです。 Windows Vista 以降向けにリリースされた Windows SDK ではヘッダーファイルの構成が変更されており、SOCKADDR_IN 構造体は Ws2def.h ヘッダーファイルで定義されています。Ws2def.h ヘッダーファイルは Winsock2.h に自動的にインクルードされるため、直接使用しないでください。 | ||||||||
| Ipv6 | SOCKADDR_IN6 | 32/28 | +0 | +0 | アドレスファミリーと IPv6 アドレスを格納する SOCKADDR_IN6 構造体として表される IPv6 アドレスです。アドレスファミリーはホストバイトオーダー、IPv6 アドレスはネットワークバイトオーダーです。 Windows Vista 以降向けにリリースされた Windows SDK ではヘッダーファイルの構成が変更されており、SOCKADDR_IN6 構造体は Ws2def.h ヘッダーファイルで定義されています。Ws2def.h ヘッダーファイルは Winsock2.h に自動的にインクルードされるため、直接使用しないでください。 | ||||||||
| si_family | ADDRESS_FAMILY | 2 | +0 | +0 | アドレスファミリーです。 アドレスファミリーに指定できる値は Ws2def.h ヘッダーファイルに記載されています。AF_ アドレスファミリー定数と PF_ プロトコルファミリー定数の値は同一である (たとえば AF_INET と PF_INET) ため、どちらの定数も使用できます。Ws2def.h ヘッダーファイルは Winsock2.h に自動的にインクルードされるため、直接使用しないでください。 現在サポートされている値は AF_INET、AF_INET6、AF_UNSPEC です。
|
公式ドキュメント
SOCKADDR_INET 共用体は、IPv4 アドレス、IPv6 アドレス、またはアドレスファミリーを格納します。
解説(Remarks)
SOCKADDR_INET 共用体は Windows Vista 以降で定義されています。
SOCKADDR_INET 共用体は、sockaddr 構造体をキャストすることなく、IPv4 アドレス、IPv6 アドレス、または IP アドレスファミリーにアクセスするための便利な構造体です。
SOCKADDR_INET 共用体は、IP_ADDRESS_PREFIX 構造体の Prefix メンバーのデータ型です。
Ws2ipdef.h ヘッダーファイルは Ws2tcpip.h ヘッダーファイルに自動的にインクルードされるため、直接使用しないでください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// 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 (x64 32 / x86 28 バイト)
typedef struct SOCKADDR_IN6 {
ADDRESS_FAMILY sin6_family;
WORD sin6_port;
DWORD sin6_flowinfo;
IN6_ADDR sin6_addr;
_Anonymous_e__Union Anonymous;
} SOCKADDR_IN6;
// SOCKADDR_INET (x64 32 / x86 28 バイト)
typedef struct SOCKADDR_INET {
SOCKADDR_IN Ipv4;
SOCKADDR_IN6 Ipv6;
ADDRESS_FAMILY si_family;
} SOCKADDR_INET;using System;
using System.Runtime.InteropServices;
[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
{
public ushort sin6_family;
public ushort sin6_port;
public uint sin6_flowinfo;
public IN6_ADDR sin6_addr;
public _Anonymous_e__Union Anonymous;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SOCKADDR_INET
{
public SOCKADDR_IN Ipv4;
public SOCKADDR_IN6 Ipv6;
public ushort si_family;
}Imports System.Runtime.InteropServices
<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
Public sin6_family As UShort
Public sin6_port As UShort
Public sin6_flowinfo As UInteger
Public sin6_addr As IN6_ADDR
Public Anonymous As _Anonymous_e__Union
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SOCKADDR_INET
Public Ipv4 As SOCKADDR_IN
Public Ipv6 As SOCKADDR_IN6
Public si_family As UShort
End Structureimport ctypes
from ctypes import wintypes
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(ctypes.Structure):
_fields_ = [
("sin6_family", ctypes.c_ushort),
("sin6_port", ctypes.c_ushort),
("sin6_flowinfo", wintypes.DWORD),
("sin6_addr", IN6_ADDR),
("Anonymous", _Anonymous_e__Union),
]
class SOCKADDR_INET(ctypes.Structure):
_fields_ = [
("Ipv4", SOCKADDR_IN),
("Ipv6", SOCKADDR_IN6),
("si_family", ctypes.c_ushort),
]#[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 {
pub sin6_family: u16,
pub sin6_port: u16,
pub sin6_flowinfo: u32,
pub sin6_addr: IN6_ADDR,
pub Anonymous: _Anonymous_e__Union,
}
#[repr(C)]
pub struct SOCKADDR_INET {
pub Ipv4: SOCKADDR_IN,
pub Ipv6: SOCKADDR_IN6,
pub si_family: u16,
}import "golang.org/x/sys/windows"
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 struct {
sin6_family uint16
sin6_port uint16
sin6_flowinfo uint32
sin6_addr IN6_ADDR
Anonymous _Anonymous_e__Union
}
type SOCKADDR_INET struct {
Ipv4 SOCKADDR_IN
Ipv6 SOCKADDR_IN6
si_family uint16
}type
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 = record
sin6_family: Word;
sin6_port: Word;
sin6_flowinfo: DWORD;
sin6_addr: IN6_ADDR;
Anonymous: _Anonymous_e__Union;
end;
SOCKADDR_INET = record
Ipv4: SOCKADDR_IN;
Ipv6: SOCKADDR_IN6;
si_family: Word;
end;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 = extern struct {
sin6_family: u16,
sin6_port: u16,
sin6_flowinfo: u32,
sin6_addr: IN6_ADDR,
Anonymous: _Anonymous_e__Union,
};
const SOCKADDR_INET = extern struct {
Ipv4: SOCKADDR_IN,
Ipv6: SOCKADDR_IN6,
si_family: u16,
};type
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 {.bycopy.} = object
sin6_family: uint16
sin6_port: uint16
sin6_flowinfo: uint32
sin6_addr: IN6_ADDR
Anonymous: _Anonymous_e__Union
SOCKADDR_INET {.bycopy.} = object
Ipv4: SOCKADDR_IN
Ipv6: SOCKADDR_IN6
si_family: uint16struct 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
{
ushort sin6_family;
ushort sin6_port;
uint sin6_flowinfo;
IN6_ADDR sin6_addr;
_Anonymous_e__Union Anonymous;
}
struct SOCKADDR_INET
{
SOCKADDR_IN Ipv4;
SOCKADDR_IN6 Ipv6;
ushort si_family;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; SOCKADDR_INET サイズ: 28 バイト(x86)
dim st, 7 ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; Ipv4 : SOCKADDR_IN (+0, 16byte) varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; Ipv6 : SOCKADDR_IN6 (+0, 28byte) varptr(st)+0 を基点に操作(28byte:入れ子/配列)
; si_family : ADDRESS_FAMILY (+0, 2byte) wpoke st,0,値 / 値 = wpeek(st,0)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SOCKADDR_INET サイズ: 32 バイト(x64)
dim st, 8 ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; Ipv4 : SOCKADDR_IN (+0, 24byte) varptr(st)+0 を基点に操作(24byte:入れ子/配列)
; Ipv6 : SOCKADDR_IN6 (+0, 32byte) varptr(st)+0 を基点に操作(32byte:入れ子/配列)
; si_family : ADDRESS_FAMILY (+0, 2byte) wpoke st,0,値 / 値 = wpeek(st,0)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global IN_ADDR
#field byte S_un 8
#endstruct
#defstruct global SOCKADDR_IN
#field short sin_family
#field short sin_port
#field IN_ADDR sin_addr
#field byte sin_zero 8
#endstruct
#defstruct global IN6_ADDR
#field byte u 16
#endstruct
#defstruct global SOCKADDR_IN6
#field short sin6_family
#field short sin6_port
#field int sin6_flowinfo
#field IN6_ADDR sin6_addr
#field byte Anonymous 8
#endstruct
#defstruct global SOCKADDR_INET
#field SOCKADDR_IN Ipv4
#field SOCKADDR_IN6 Ipv6
#field short si_family
#endstruct
stdim st, SOCKADDR_INET ; NSTRUCT 変数を確保
st->si_family = 100
mes "si_family=" + st->si_family