ADDRINFOEX2W
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ai_flags | INT | 4 | +0 | +0 | GetAddrInfoEx 関数で使用されるオプションを示すフラグです。 ai_flags メンバーでサポートされる値は Winsock2.h インクルードファイルで定義されており、次のオプションを組み合わせて指定できます。
| ||||||||||||||||||||||||||
| ai_family | INT | 4 | +4 | +4 | アドレスファミリーです。 アドレスファミリーに指定できる値は Ws2def.h ヘッダーファイルで定義されています。Ws2def.h ヘッダーファイルは Winsock2.h に自動的にインクルードされるため、直接使用しないでください。 現在サポートされている値は AF_INET または AF_INET6 で、これらはそれぞれ IPv4 と IPv6 のインターネットアドレスファミリー形式です。アドレスファミリーのその他の選択肢 (たとえば NetBIOS で使用する AF_NETBIOS など) は、そのアドレスファミリー用の Windows ソケットサービスプロバイダーがインストールされている場合にサポートされます。なお、AF_ アドレスファミリー定数と PF_ プロトコルファミリー定数の値は同一である (たとえば AF_INET と PF_INET) ため、どちらの定数も使用できます。 次の表はアドレスファミリーの代表的な値を示したものですが、これ以外にも多くの値を指定できます。
| ||||||||||||||||||||||||||
| ai_socktype | INT | 4 | +8 | +8 | ソケットの種類です。ソケットの種類に指定できる値は Winsock2.h インクルードファイルで定義されています。 次の表は、Windows Sockets 2 でサポートされるソケットの種類に指定できる値を示します。
Windows Sockets 2 では、新しいソケットの種類が導入されました。アプリケーションは WSAEnumProtocols 関数を使用して、利用可能な各トランスポートプロトコルの属性を動的に検出できます。そのため、アプリケーションはアドレスファミリーに対して指定できるソケットの種類とプロトコルのオプションを判別し、この情報を使用してこのパラメーターを指定できます。Winsock2.h および Ws2def.h ヘッダーファイル内のソケットの種類の定義は、新しいソケットの種類、アドレスファミリー、プロトコルが定義されるたびに随時更新されます。 Windows Sockets 1.1 では、指定できるソケットの種類は SOCK_DATAGRAM と SOCK_STREAM のみです。 | ||||||||||||||||||||||||||
| ai_protocol | INT | 4 | +12 | +12 | プロトコルの種類です。指定できる選択肢は、指定されたアドレスファミリーとソケットの種類に依存します。ai_protocol に指定できる値は Winsock2.h および Wsrm.h ヘッダーファイルで定義されています。 Windows Vista 以降向けにリリースされた Windows SDK では、ヘッダーファイルの構成が変更されており、このメンバーには Ws2def.h ヘッダーファイルで定義されている IPPROTO 列挙型の値を指定できます。なお、Ws2def.h ヘッダーファイルは Winsock2.h に自動的にインクルードされるため、直接使用しないでください。 ai_protocol に 0 を指定した場合、呼び出し元はプロトコルの指定を望んでおらず、サービスプロバイダーが使用する ai_protocol を選択します。IPv4 および IPv6 以外のプロトコルでは、ai_protocol に 0 を設定してください。 次の表は ai_protocol メンバーの代表的な値を示したものですが、これ以外にも多くの値を指定できます。
ai_family メンバーが AF_IRDA の場合、ai_protocol は 0 でなければなりません。 | ||||||||||||||||||||||||||
| ai_addrlen | UINT_PTR | 8/4 | +16 | +16 | ai_addr メンバーが指すバッファーの長さ (バイト単位) です。 | ||||||||||||||||||||||||||
| ai_canonname | LPWSTR | 8/4 | +24 | +20 | ホストの正規名です。 | ||||||||||||||||||||||||||
| ai_addr | SOCKADDR* | 8/4 | +32 | +24 | sockaddr 構造体へのポインターです。返される各 addrinfoex2 構造体の ai_addr メンバーは、値が設定されたソケットアドレス構造体を指します。返される各 addrinfoex2 構造体の長さ (バイト単位) は ai_addrlen メンバーで指定されます。 | ||||||||||||||||||||||||||
| ai_blob | void* | 8/4 | +40 | +28 | アドレスの一覧以外に、名前に関連付けられたプロバイダー固有の名前空間情報を返すために使用されるデータへのポインターです。ai_blob が指すバッファーの長さ (バイト単位) は ai_bloblen メンバーで指定する必要があります。 | ||||||||||||||||||||||||||
| ai_bloblen | UINT_PTR | 8/4 | +48 | +32 | ai_blob メンバーの長さ (バイト単位) です。 | ||||||||||||||||||||||||||
| ai_provider | GUID* | 8/4 | +56 | +36 | 特定の名前空間プロバイダーの GUID へのポインターです。 | ||||||||||||||||||||||||||
| ai_next | ADDRINFOEX2W* | 8/4 | +64 | +40 | リンクリスト内の次の構造体へのポインターです。このパラメーターは、リンクリストの最後の addrinfoex2 構造体では NULL に設定されます。 | ||||||||||||||||||||||||||
| ai_version | INT | 4 | +72 | +44 | この構造体のバージョン番号です。このバージョンの構造体で現在使用されている値は 2 です。 | ||||||||||||||||||||||||||
| ai_fqdn | LPWSTR | 8/4 | +80 | +48 | ホストの完全修飾ドメイン名です。 |
公式ドキュメント
addrinfoex2 構造体は、正規名と完全修飾ドメイン名の両方が要求された場合に、ホストのアドレス情報を保持するために GetAddrInfoEx 関数によって使用されます。
解説(Remarks)
addrinfoex2 構造体は Windows 8 および Windows Server 2012 でサポートされます。
addrinfoex2 構造体は、GetAddrInfoEx 関数の hints パラメーターに指定する省略可能な addrinfoex 構造体の ai_flags メンバーで AI_FQDN ビットと AI_CANONNAME ビットの両方が設定されている場合に、ホストのアドレス情報を保持するために使用されます。addrinfoex2 構造体は addrinfoex 構造体の拡張版であり、ホストの正規名と完全修飾ドメイン名の両方を返すことができます。追加された構造体メンバーは、構造体のバージョン番号とホストの完全修飾ドメイン名のためのものです。
GetAddrInfoEx 関数で使用される addrinfoex2 構造体は、getaddrinfo 関数および GetAddrInfoW 関数で使用される addrinfo 構造体および addrinfoW 構造体の拡張版です。GetAddrInfoEx 関数では、クエリを解決する名前空間プロバイダーを指定できます。IPv6 および IPv4 プロトコルで使用する場合、名前解決は Domain Name System (DNS)、ローカルの hosts ファイル、電子メールプロバイダー (NS_EMAIL 名前空間)、またはその他の名前付け機構によって行われます。
ai_blob メンバーの blob データは、名前に関連付けられたプロバイダー固有の追加の名前空間情報を返すために使用されます。ai_blob メンバー内のデータの形式は、個々の名前空間プロバイダーに固有です。現在、blob データは NS_EMAIL 名前空間プロバイダーが追加情報を提供するために使用しています。
UNICODE または _UNICODE が定義されている場合、addrinfoex2 はこの構造体の Unicode 版である addrinfoex2W として定義されます。文字列パラメーターは PWSTR データ型として定義され、addrinfoex2W 構造体が使用されます。
UNICODE または _UNICODE が定義されていない場合、addrinfoex2 はこの構造体の ANSI 版である addrinfoex2A として定義されます。文字列パラメーターは char * データ型となり、addrinfoex2A 構造体が使用されます。
GetAddrInfoEx の呼び出しに成功すると、GetAddrInfoEx 関数に渡された ppResult パラメーターに addrinfoex2 構造体のリンクリストが返されます。このリストは、返された各 addrinfoex2 構造体の ai_next メンバーに格納されたポインターを、NULL ポインターに達するまでたどることで処理できます。返される各 addrinfoex2 構造体の ai_family、ai_socktype、ai_protocol の各メンバーは、 socket 関数または WSASocket 関数の呼び出しにおける対応する引数に対応します。また、返される各 addrinfoex2 構造体の ai_addr メンバーは、値が設定されたソケットアドレス構造体を指し、その長さは ai_addrlen メンバーで指定されます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// ADDRINFOEX2W (x64 88 / x86 52 バイト)
typedef struct ADDRINFOEX2W {
INT ai_flags;
INT ai_family;
INT ai_socktype;
INT ai_protocol;
UINT_PTR ai_addrlen;
LPWSTR ai_canonname;
SOCKADDR* ai_addr;
void* ai_blob;
UINT_PTR ai_bloblen;
GUID* ai_provider;
ADDRINFOEX2W* ai_next;
INT ai_version;
LPWSTR ai_fqdn;
} ADDRINFOEX2W;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ADDRINFOEX2W
{
public int ai_flags;
public int ai_family;
public int ai_socktype;
public int ai_protocol;
public UIntPtr ai_addrlen;
public IntPtr ai_canonname;
public IntPtr ai_addr;
public IntPtr ai_blob;
public UIntPtr ai_bloblen;
public IntPtr ai_provider;
public IntPtr ai_next;
public int ai_version;
public IntPtr ai_fqdn;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure ADDRINFOEX2W
Public ai_flags As Integer
Public ai_family As Integer
Public ai_socktype As Integer
Public ai_protocol As Integer
Public ai_addrlen As UIntPtr
Public ai_canonname As IntPtr
Public ai_addr As IntPtr
Public ai_blob As IntPtr
Public ai_bloblen As UIntPtr
Public ai_provider As IntPtr
Public ai_next As IntPtr
Public ai_version As Integer
Public ai_fqdn As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class ADDRINFOEX2W(ctypes.Structure):
_fields_ = [
("ai_flags", ctypes.c_int),
("ai_family", ctypes.c_int),
("ai_socktype", ctypes.c_int),
("ai_protocol", ctypes.c_int),
("ai_addrlen", ctypes.c_size_t),
("ai_canonname", ctypes.c_void_p),
("ai_addr", ctypes.c_void_p),
("ai_blob", ctypes.c_void_p),
("ai_bloblen", ctypes.c_size_t),
("ai_provider", ctypes.c_void_p),
("ai_next", ctypes.c_void_p),
("ai_version", ctypes.c_int),
("ai_fqdn", ctypes.c_void_p),
]#[repr(C)]
pub struct ADDRINFOEX2W {
pub ai_flags: i32,
pub ai_family: i32,
pub ai_socktype: i32,
pub ai_protocol: i32,
pub ai_addrlen: usize,
pub ai_canonname: *mut core::ffi::c_void,
pub ai_addr: *mut core::ffi::c_void,
pub ai_blob: *mut core::ffi::c_void,
pub ai_bloblen: usize,
pub ai_provider: *mut core::ffi::c_void,
pub ai_next: *mut core::ffi::c_void,
pub ai_version: i32,
pub ai_fqdn: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type ADDRINFOEX2W struct {
ai_flags int32
ai_family int32
ai_socktype int32
ai_protocol int32
ai_addrlen uintptr
ai_canonname uintptr
ai_addr uintptr
ai_blob uintptr
ai_bloblen uintptr
ai_provider uintptr
ai_next uintptr
ai_version int32
ai_fqdn uintptr
}type
ADDRINFOEX2W = record
ai_flags: Integer;
ai_family: Integer;
ai_socktype: Integer;
ai_protocol: Integer;
ai_addrlen: NativeUInt;
ai_canonname: Pointer;
ai_addr: Pointer;
ai_blob: Pointer;
ai_bloblen: NativeUInt;
ai_provider: Pointer;
ai_next: Pointer;
ai_version: Integer;
ai_fqdn: Pointer;
end;const ADDRINFOEX2W = extern struct {
ai_flags: i32,
ai_family: i32,
ai_socktype: i32,
ai_protocol: i32,
ai_addrlen: usize,
ai_canonname: ?*anyopaque,
ai_addr: ?*anyopaque,
ai_blob: ?*anyopaque,
ai_bloblen: usize,
ai_provider: ?*anyopaque,
ai_next: ?*anyopaque,
ai_version: i32,
ai_fqdn: ?*anyopaque,
};type
ADDRINFOEX2W {.bycopy.} = object
ai_flags: int32
ai_family: int32
ai_socktype: int32
ai_protocol: int32
ai_addrlen: uint
ai_canonname: pointer
ai_addr: pointer
ai_blob: pointer
ai_bloblen: uint
ai_provider: pointer
ai_next: pointer
ai_version: int32
ai_fqdn: pointerstruct ADDRINFOEX2W
{
int ai_flags;
int ai_family;
int ai_socktype;
int ai_protocol;
size_t ai_addrlen;
void* ai_canonname;
void* ai_addr;
void* ai_blob;
size_t ai_bloblen;
void* ai_provider;
void* ai_next;
int ai_version;
void* ai_fqdn;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; ADDRINFOEX2W サイズ: 52 バイト(x86)
dim st, 13 ; 4byte整数×13(構造体サイズ 52 / 4 切り上げ)
; ai_flags : INT (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; ai_family : INT (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; ai_socktype : INT (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; ai_protocol : INT (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; ai_addrlen : UINT_PTR (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; ai_canonname : LPWSTR (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; ai_addr : SOCKADDR* (+24, 4byte) varptr(st)+24 を基点に操作(4byte:入れ子/配列)
; ai_blob : void* (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; ai_bloblen : UINT_PTR (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; ai_provider : GUID* (+36, 4byte) varptr(st)+36 を基点に操作(4byte:入れ子/配列)
; ai_next : ADDRINFOEX2W* (+40, 4byte) varptr(st)+40 を基点に操作(4byte:入れ子/配列)
; ai_version : INT (+44, 4byte) st.11 = 値 / 値 = st.11 (lpoke/lpeek も可)
; ai_fqdn : LPWSTR (+48, 4byte) st.12 = 値 / 値 = st.12 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; ADDRINFOEX2W サイズ: 88 バイト(x64)
dim st, 22 ; 4byte整数×22(構造体サイズ 88 / 4 切り上げ)
; ai_flags : INT (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; ai_family : INT (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; ai_socktype : INT (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; ai_protocol : INT (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; ai_addrlen : UINT_PTR (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; ai_canonname : LPWSTR (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; ai_addr : SOCKADDR* (+32, 8byte) varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; ai_blob : void* (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; ai_bloblen : UINT_PTR (+48, 8byte) qpoke st,48,値 / qpeek(st,48) ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; ai_provider : GUID* (+56, 8byte) varptr(st)+56 を基点に操作(8byte:入れ子/配列)
; ai_next : ADDRINFOEX2W* (+64, 8byte) varptr(st)+64 を基点に操作(8byte:入れ子/配列)
; ai_version : INT (+72, 4byte) st.18 = 値 / 値 = st.18 (lpoke/lpeek も可)
; ai_fqdn : LPWSTR (+80, 8byte) qpoke st,80,値 / qpeek(st,80) ※IronHSPのみ。3.7/3.8は lpoke st,80,下位 : lpoke st,84,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global ADDRINFOEX2W
#field int ai_flags
#field int ai_family
#field int ai_socktype
#field int ai_protocol
#field intptr ai_addrlen
#field intptr ai_canonname
#field intptr ai_addr
#field intptr ai_blob
#field intptr ai_bloblen
#field intptr ai_provider
#field intptr ai_next
#field int ai_version
#field intptr ai_fqdn
#endstruct
stdim st, ADDRINFOEX2W ; NSTRUCT 変数を確保
st->ai_flags = 100
mes "ai_flags=" + st->ai_flags