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

SOCKADDR_IN6_W2KSP1

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

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

フィールド

フィールド型サイズx64x86説明
sin6_familySHORT2+0+0転送アドレスのアドレスファミリです。このメンバーは常に AF_INET6 に設定してください。
sin6_portWORD2+2+2トランスポートプロトコルのポート番号です。
sin6_flowinfoDWORD4+4+4IPv6 のフロー情報です。
sin6_addrIN6_ADDR16+8+8IPv6 の転送アドレスを格納する IN6_ADDR 構造体です。
sin6_scope_idDWORD4+24+24

sin6_scope_struct メンバーで定義される IPv6 スコープ識別子の ULONG 表現です。

- sin6_scope_struct

IPv6 転送アドレスのスコープ識別子を格納する SCOPE_ID 構造体です。SCOPE_ID 構造体は 次のように定義されています。

typedef struct {
  union {
    struct {
      ULONG  Zone : 28;
      ULONG  Level : 4;
    };
    ULONG  Value;
  };
} SCOPE_ID, *PSCOPE_ID;

Zone

転送アドレスが属するゾーンを識別するゾーンインデックスです。スコープごとのゾーンは、 次のようにインスタンス化されます。

  • ノード上の各インターフェイスは、インターフェイスローカルスコープの単一のゾーンを構成します。
  • 各リンクと、そのリンクに接続されたインターフェイスは、リンクローカルスコープの単一の ゾーンを構成します。
  • インターネット上のすべてのリンクとインターフェイスから成る、グローバルスコープの単一の ゾーンが存在します。
  • インターフェイスローカル、リンクローカル、グローバル以外のスコープを持つゾーンの境界は、 ネットワーク管理者が定義します。
0 を指定すると、既定のゾーンを表します。

Level

IPv6 転送アドレスのスコープです。このスコープは、IPv6 転送アドレスに埋め込まれている IPv6 スコープ値と同じでなければなりません。このメンバーには次のいずれかを指定できます。

ScopeLevelInterface

転送アドレスはインターフェイスローカルスコープを持ちます。

ScopeLevelLink

転送アドレスはリンクローカルスコープを持ちます。

ScopeLevelSubnet

転送アドレスはサブネットローカルスコープを持ちます。

ScopeLevelAdmin

転送アドレスは管理ローカルスコープを持ちます。

ScopeLevelSite

転送アドレスはサイトローカルスコープを持ちます。

ScopeLevelOrganization

転送アドレスは組織ローカルスコープを持ちます。

ScopeLevelGlobal

転送アドレスはグローバルスコープを持ちます。

Value

IPv6 スコープ識別子の ULONG 表現です。

- sin6_scope_struct.Level

IPv6 転送アドレスのスコープです。このスコープは、IPv6 転送アドレスに埋め込まれている IPv6 スコープ値と同じでなければなりません。このメンバーには次のいずれかを指定できます。

ScopeLevelInterface

転送アドレスはインターフェイスローカルスコープを持ちます。

ScopeLevelLink

転送アドレスはリンクローカルスコープを持ちます。

ScopeLevelSubnet

転送アドレスはサブネットローカルスコープを持ちます。

ScopeLevelAdmin

転送アドレスは管理ローカルスコープを持ちます。

ScopeLevelSite

転送アドレスはサイトローカルスコープを持ちます。

ScopeLevelOrganization

転送アドレスは組織ローカルスコープを持ちます。

ScopeLevelGlobal

転送アドレスはグローバルスコープを持ちます。

- sin6_scope_struct.Value

IPv6 スコープ識別子の ULONG 表現です。

- sin6_scope_struct.Zone

転送アドレスが属するゾーンを識別するゾーンインデックスです。スコープごとのゾーンは、 次のようにインスタンス化されます。

  • ノード上の各インターフェイスは、インターフェイスローカルスコープの単一のゾーンを構成します。
  • 各リンクと、そのリンクに接続されたインターフェイスは、リンクローカルスコープの単一の ゾーンを構成します。
  • インターネット上のすべてのリンクとインターフェイスから成る、グローバルスコープの単一の ゾーンが存在します。
  • インターフェイスローカル、リンクローカル、グローバル以外のスコープを持つゾーンの境界は、 ネットワーク管理者が定義します。
0 を指定すると、既定のゾーンを表します。

公式ドキュメント

SOCKADDR_IN6 構造体は、 AF_INET6 アドレスファミリの転送アドレスとポートを指定します。

解説(Remarks)

SOCKADDR_IN6 構造体内のデータは、アドレスファミリを除き、すべてネットワークバイトオーダー (ビッグエンディアン) で指定しなければなりません。

SOCKADDR_IN6 構造体のサイズは大きすぎるため、 SOCKADDR 構造体が提供するメモリ領域には収まりません。あらゆるアドレスファミリの転送アドレスを格納できる大きさが保証された構造体については、 SOCKADDR_STORAGE を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
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;

// SOCKADDR_IN6_W2KSP1  (x64 28 / x86 28 バイト)
typedef struct SOCKADDR_IN6_W2KSP1 {
    SHORT sin6_family;
    WORD sin6_port;
    DWORD sin6_flowinfo;
    IN6_ADDR sin6_addr;
    DWORD sin6_scope_id;
} SOCKADDR_IN6_W2KSP1;
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 SOCKADDR_IN6_W2KSP1
{
    public short sin6_family;
    public ushort sin6_port;
    public uint sin6_flowinfo;
    public IN6_ADDR sin6_addr;
    public uint sin6_scope_id;
}
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 SOCKADDR_IN6_W2KSP1
    Public sin6_family As Short
    Public sin6_port As UShort
    Public sin6_flowinfo As UInteger
    Public sin6_addr As IN6_ADDR
    Public sin6_scope_id As UInteger
End Structure
import ctypes
from ctypes import wintypes

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

class SOCKADDR_IN6_W2KSP1(ctypes.Structure):
    _fields_ = [
        ("sin6_family", ctypes.c_short),
        ("sin6_port", ctypes.c_ushort),
        ("sin6_flowinfo", wintypes.DWORD),
        ("sin6_addr", IN6_ADDR),
        ("sin6_scope_id", wintypes.DWORD),
    ]
#[repr(C)]
pub struct IN6_ADDR {
    pub u: _u_e__Union,
}

#[repr(C)]
pub struct SOCKADDR_IN6_W2KSP1 {
    pub sin6_family: i16,
    pub sin6_port: u16,
    pub sin6_flowinfo: u32,
    pub sin6_addr: IN6_ADDR,
    pub sin6_scope_id: u32,
}
import "golang.org/x/sys/windows"

type IN6_ADDR struct {
	u _u_e__Union
}

type SOCKADDR_IN6_W2KSP1 struct {
	sin6_family int16
	sin6_port uint16
	sin6_flowinfo uint32
	sin6_addr IN6_ADDR
	sin6_scope_id uint32
}
type
  IN6_ADDR = record
    u: _u_e__Union;
  end;

  SOCKADDR_IN6_W2KSP1 = record
    sin6_family: Smallint;
    sin6_port: Word;
    sin6_flowinfo: DWORD;
    sin6_addr: IN6_ADDR;
    sin6_scope_id: DWORD;
  end;
const IN6_ADDR = extern struct {
    u: _u_e__Union,
};

const SOCKADDR_IN6_W2KSP1 = extern struct {
    sin6_family: i16,
    sin6_port: u16,
    sin6_flowinfo: u32,
    sin6_addr: IN6_ADDR,
    sin6_scope_id: u32,
};
type
  IN6_ADDR {.bycopy.} = object
    u: _u_e__Union

  SOCKADDR_IN6_W2KSP1 {.bycopy.} = object
    sin6_family: int16
    sin6_port: uint16
    sin6_flowinfo: uint32
    sin6_addr: IN6_ADDR
    sin6_scope_id: uint32
struct IN6_ADDR
{
    _u_e__Union u;
}

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

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SOCKADDR_IN6_W2KSP1 サイズ: 28 バイト(x64)
dim st, 7    ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; sin6_family : SHORT (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; sin6_port : WORD (+2, 2byte)  wpoke st,2,値  /  値 = wpeek(st,2)
; sin6_flowinfo : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; sin6_addr : IN6_ADDR (+8, 16byte)  varptr(st)+8 を基点に操作(16byte:入れ子/配列)
; sin6_scope_id : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (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 SOCKADDR_IN6_W2KSP1
    #field short sin6_family
    #field short sin6_port
    #field int sin6_flowinfo
    #field IN6_ADDR sin6_addr
    #field int sin6_scope_id
#endstruct

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