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

ADDRINFOEX3

構造体
サイズx64: 96 バイト / x86: 56 バイト

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

フィールド

フィールドサイズx64x86説明
ai_flagsINT4+0+0

GetAddrInfoEx 関数で使用されるオプションを示すフラグです。

ai_flags メンバーでサポートされる値は Winsock2.h インクルード ファイルで定義されており、次のオプションを組み合わせて指定できます。

意味
AI_PASSIVE
0x01
ソケット アドレスは bind 関数の呼び出しで使用されます。
AI_CANONNAME
0x02
正規名が最初の ai_canonname メンバーに返されます。
AI_NUMERICHOST
0x04
GetAddrInfoEx 関数に渡される nodename パラメーターは数値文字列でなければなりません。
AI_ALL
0x0100
このビットが設定されている場合、IPv6 アドレスと、AI_V4MAPPED による IPv4 アドレスの要求が行われます。

このオプションは Windows Vista 以降でサポートされます。

AI_ADDRCONFIG
0x0400
GetAddrInfoEx は、グローバル アドレスが構成されている場合にのみ名前解決を行います。IPv6 および IPv4 のループバック アドレスは、有効なグローバル アドレスとは見なされません。

このオプションは Windows Vista 以降でサポートされます。

AI_V4MAPPED
0x0800
IPv6 アドレスに対する GetAddrInfoEx の要求が失敗した場合、IPv4 アドレスに対する名前サービス要求が行われ、それらのアドレスは IPv4 射影 IPv6 アドレス形式に変換されます。

このオプションは Windows Vista 以降でサポートされます。

AI_NON_AUTHORITATIVE
0x04000
アドレス情報が非権威的な結果によるものであることを示します。

このオプションが GetAddrInfoExpHints パラメーターに設定されている場合、NS_EMAIL 名前空間プロバイダーは権威的な結果と非権威的な結果の両方を返します。このオプションが設定されていない場合は、権威的な結果のみが返されます。

このオプションは、NS_EMAIL 名前空間に対して Windows Vista 以降でのみサポートされます。

AI_SECURE
0x08000
アドレス情報がセキュリティで保護されたチャネルによるものであることを示します。

AI_SECURE ビットが設定されている場合、NS_EMAIL 名前空間プロバイダーは、なりすましの可能性を最小限に抑えるために強化されたセキュリティで取得された結果を返します。

このオプションが GetAddrInfoExpHints パラメーターに設定されている場合、NS_EMAIL 名前空間プロバイダーは、なりすましの可能性を最小限に抑えるために強化されたセキュリティで取得された結果のみを返します。

このオプションは、NS_EMAIL 名前空間に対して Windows Vista 以降でのみサポートされます。

AI_RETURN_PREFERRED_NAMES
0x010000
アドレス情報が、特定の名前空間で公開するための優先名に関するものであることを示します。

このオプションが GetAddrInfoExpHints パラメーターに設定されている場合、pName パラメーターには名前を指定せず、NS_EMAIL 名前空間プロバイダーが公開用の優先名を返します。

このオプションは、NS_EMAIL 名前空間に対して Windows Vista 以降でのみサポートされます。

AI_FQDN
0x00020000
完全修飾ドメイン名が最初の ai_fqdn メンバーに返されます。

このオプションが GetAddrInfoExpHints パラメーターに設定され、pName パラメーターにフラット名 (単一ラベル) が指定されている場合、その名前が最終的に解決された完全修飾ドメイン名が返されます。

このオプションは Windows 7、Windows Server 2008 R2 以降でサポートされます。

AI_FILESERVER
0x00040000
照会されているホスト名がファイル共有のシナリオで使用されていることを名前空間プロバイダーに伝えるヒントです。名前空間プロバイダーはこのヒントを無視する場合があります。

このオプションは Windows 7、Windows Server 2008 R2 以降でサポートされます。

AI_DISABLE_IDN_ENCODING
0x00080000
GetAddrInfoEx 関数から呼び出される名前解決関数において、Punycode を使用した国際化ドメイン名の自動エンコードを無効にします。

このオプションは Windows 8、Windows Server 2012 以降でサポートされます。

AI_EXTENDED
0x80000000
現在のオブジェクトが拡張されていること、つまり addrinfoex2 以降であることを示します。

このオプションは Windows 8.1、Windows Server 2012 R2 以降でサポートされます。

ai_familyINT4+4+4

アドレス ファミリーです。

アドレス ファミリーに指定できる値は Ws2def.h ヘッダー ファイルで定義されています。Ws2def.h ヘッダー ファイルは Winsock2.h に自動的にインクルードされるため、直接使用しないでください。

現在サポートされている値は AF_INET または AF_INET6 で、これらは IPv4 および IPv6 のインターネット アドレス ファミリー形式です。その他のアドレス ファミリーのオプション (たとえば NetBIOS で使用する AF_NETBIOS) は、そのアドレス ファミリー用の Windows ソケット サービス プロバイダーがインストールされていればサポートされます。AF_ アドレス ファミリー定数と PF_ プロトコル ファミリー定数の値は同一である (たとえば AF_INETPF_INET) ため、どちらの定数も使用できます。

次の表はアドレス ファミリーの一般的な値を示していますが、他にも多くの値を指定できます。

意味
AF_UNSPEC
0
アドレス ファミリーは指定されていません。
AF_INET
2
インターネット プロトコル バージョン 4 (IPv4) のアドレス ファミリーです。
AF_NETBIOS
17
NetBIOS のアドレス ファミリーです。このアドレス ファミリーは、NetBIOS 用の Windows ソケット プロバイダーがインストールされている場合にのみサポートされます。
AF_INET6
23
インターネット プロトコル バージョン 6 (IPv6) のアドレス ファミリーです。
AF_IRDA
26
赤外線データ協会 (IrDA) のアドレス ファミリーです。このアドレス ファミリーは、コンピューターに赤外線ポートとドライバーがインストールされている場合にのみサポートされます。
AF_BTH
32
Bluetooth のアドレス ファミリーです。このアドレス ファミリーは、Bluetooth アダプターがインストールされている場合にのみサポートされます。
ai_socktypeINT4+8+8

ソケットの種類です。ソケットの種類に指定できる値は Winsock2.h インクルード ファイルで定義されています。

次の表は、Windows Sockets 2 でサポートされるソケットの種類に指定できる値を示しています。

意味
SOCK_STREAM
1
順序付けされた、信頼性のある双方向の接続ベースのバイト ストリームを、OOB データ送信メカニズムとともに提供します。インターネット アドレス ファミリー (AF_INET または AF_INET6) では伝送制御プロトコル (TCP) を使用します。ai_family メンバーが AF_IRDA の場合、サポートされるソケットの種類は SOCK_STREAM のみです。
SOCK_DGRAM
2
データグラムをサポートします。データグラムはコネクションレスで信頼性のない、固定の (通常は小さい) 最大長を持つバッファーです。インターネット アドレス ファミリー (AF_INET または AF_INET6) ではユーザー データグラム プロトコル (UDP) を使用します。
SOCK_RAW
3
アプリケーションが 1 つ上位層のプロトコル ヘッダーを操作できる raw ソケットを提供します。IPv4 ヘッダーを操作するには、ソケットに IP_HDRINCL ソケット オプションを設定する必要があります。IPv6 ヘッダーを操作するには、ソケットに IPV6_HDRINCL ソケット オプションを設定する必要があります。
SOCK_RDM
4
信頼性のあるメッセージ データグラムを提供します。この種類の例としては、Windows における Pragmatic General Multicast (PGM) マルチキャスト プロトコルの実装があり、信頼性のあるマルチキャスト プログラミングと呼ばれることもあります。
SOCK_SEQPACKET
5
データグラムに基づく擬似ストリーム パケットを提供します。

Windows Sockets 2 では、新しいソケットの種類が導入されました。アプリケーションは WSAEnumProtocols 関数によって、利用可能な各トランスポート プロトコルの属性を動的に検出できます。そのため、アプリケーションはアドレス ファミリーで使用できるソケットの種類とプロトコルのオプションを判断し、この情報をこのパラメーターの指定に利用できます。Winsock2.h および Ws2def.h ヘッダー ファイル内のソケットの種類の定義は、新しいソケットの種類、アドレス ファミリー、プロトコルが定義されるたびに定期的に更新されます。

Windows Sockets 1.1 で指定できるソケットの種類は、SOCK_DATAGRAMSOCK_STREAM のみです。

ai_protocolINT4+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 メンバーの一般的な値を示していますが、他にも多くの値を指定できます。

意味
IPPROTO_TCP
6
伝送制御プロトコル (TCP) です。ai_family メンバーが AF_INET または AF_INET6 で、ai_socktype メンバーが SOCK_STREAM の場合に指定できる値です。
IPPROTO_UDP
17
ユーザー データグラム プロトコル (UDP) です。ai_family メンバーが AF_INET または AF_INET6 で、type パラメーターが SOCK_DGRAM の場合に指定できる値です。
IPPROTO_RM
113
信頼性のあるマルチキャストのための PGM プロトコルです。ai_family メンバーが AF_INET で、ai_socktype メンバーが SOCK_RDM の場合に指定できる値です。Windows Vista 以降向けにリリースされた Windows SDK では、この値は IPPROTO_PGM とも呼ばれます。

ai_family メンバーが AF_IRDA の場合、ai_protocol は 0 でなければなりません。

ai_addrlenUINT_PTR8/4+16+16ai_addr メンバーが指すバッファーの長さ (バイト単位) です。
ai_canonnameLPWSTR8/4+24+20ホストの正規名です。
ai_addrSOCKADDR*8/4+32+24sockaddr 構造体へのポインターです。返される各 addrinfoex3 構造体の ai_addr メンバーは、値が設定されたソケット アドレス構造体を指します。返される各 addrinfoex3 構造体の長さ (バイト単位) は ai_addrlen メンバーで指定されます。
ai_blobvoid*8/4+40+28アドレスの一覧に加えて、名前に関連付けられたプロバイダー固有の名前空間情報を返すために使用されるデータへのポインターです。ai_blob が指すバッファーの長さ (バイト単位) は、ai_bloblen メンバーで指定する必要があります。
ai_bloblenUINT_PTR8/4+48+32ai_blob メンバーの長さ (バイト単位) です。
ai_providerGUID*8/4+56+36特定の名前空間プロバイダーの GUID へのポインターです。
ai_nextADDRINFOEX3*8/4+64+40リンク リスト内の次の構造体へのポインターです。このパラメーターは、リンク リストの最後の addrinfoex3 構造体では NULL に設定されます。
ai_versionINT4+72+44この構造体のバージョン番号です。このバージョンの構造体で現在使用されている値は 3 です。
ai_fqdnLPWSTR8/4+80+48ホストの完全修飾ドメイン名です。
ai_interfaceindexINT4+88+52GetAdaptersAddresses で返される IP_ADAPTER_ADDRESSES.IfIndex プロパティによって定義されるインターフェイス インデックスです。

公式ドキュメント

addrinfoex3 構造体は、特定のネットワーク インターフェイスが要求された場合に、ホストのアドレス情報を保持するために GetAddrInfoEx 関数によって使用されます。

解説(Remarks)

addrinfoex3 構造体は Windows 8.1 および Windows Server 2012 R2 でサポートされます。

addrinfoex3 構造体は、GetAddrInfoExhints パラメーターを通じて渡される addrinfoex3.ai_flags メンバーに AI_EXTENDED | AI_FQDN | AI_CANONNAME の各ビットが設定されている場合に、ホストのアドレス情報を保持するために GetAddrInfoEx 関数によって使用されます。あわせて、情報を取得したいインターフェイスを addrinfoex3.ai_interfaceindex メンバーに設定し、ai_version を 3 に設定する必要があります。

addrinfoex3 構造体は addrinfoex 構造体の拡張版であり、ホストの正規名と完全修飾ドメイン名を返すことができます。さらに addrinfoex は、getaddrinfo 関数および GetAddrInfoW 関数で使用される addrinfo 構造体と addrinfoW 構造体の拡張版です。GetAddrInfoEx 関数では、クエリを解決する名前空間プロバイダーを指定できます。IPv6 および IPv4 プロトコルで使用する場合、名前解決はドメイン ネーム システム (DNS)、ローカルの hosts ファイル、電子メール プロバイダー (NS_EMAIL 名前空間)、またはその他の名前付けメカニズムによって行うことができます。

ai_blob メンバー内の blob データは、名前に関連付けられたプロバイダー固有の追加の名前空間情報を返すために使用されます。ai_blob メンバー内のデータの形式は、名前空間プロバイダーごとに固有です。現在、blob データは NS_EMAIL 名前空間プロバイダーが追加情報を提供するために使用しています。

UNICODE または _UNICODE が定義されている場合、addrinfoex3 はこの構造体の Unicode 版である addrinfoex3W として定義されます。文字列パラメーターは PWSTR データ型として定義され、addrinfoex3W 構造体が使用されます。

UNICODE または _UNICODE が定義されていない場合、addrinfoex3 はこの構造体の ANSI 版である addrinfoex3A として定義されます。文字列パラメーターは char * データ型となり、addrinfoex3A 構造体が使用されます。

GetAddrInfoEx の呼び出しが成功すると、 addrinfoex3 構造体のリンク リストが、GetAddrInfoEx 関数に渡された ppResult パラメーターに返されます。このリストは、返された各 addrinfoex3 構造体の ai_next メンバーにあるポインターを NULL ポインターに達するまでたどることで処理できます。返される各 addrinfoex3 構造体の ai_familyai_socktypeai_protocol の各メンバーは、 socket 関数または WSASocket 関数の呼び出しにおける対応する引数に相当します。また、返される各 addrinfoex3 構造体の ai_addr メンバーは、値が設定されたソケット アドレス構造体を指し、その長さは ai_addrlen メンバーで指定されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// ADDRINFOEX3  (x64 96 / x86 56 バイト)
typedef struct ADDRINFOEX3 {
    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;
    ADDRINFOEX3* ai_next;
    INT ai_version;
    LPWSTR ai_fqdn;
    INT ai_interfaceindex;
} ADDRINFOEX3;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ADDRINFOEX3
{
    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;
    public int ai_interfaceindex;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure ADDRINFOEX3
    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
    Public ai_interfaceindex As Integer
End Structure
import ctypes
from ctypes import wintypes

class ADDRINFOEX3(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),
        ("ai_interfaceindex", ctypes.c_int),
    ]
#[repr(C)]
pub struct ADDRINFOEX3 {
    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,
    pub ai_interfaceindex: i32,
}
import "golang.org/x/sys/windows"

type ADDRINFOEX3 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
	ai_interfaceindex int32
}
type
  ADDRINFOEX3 = 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;
    ai_interfaceindex: Integer;
  end;
const ADDRINFOEX3 = 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,
    ai_interfaceindex: i32,
};
type
  ADDRINFOEX3 {.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: pointer
    ai_interfaceindex: int32
struct ADDRINFOEX3
{
    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;
    int ai_interfaceindex;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; ADDRINFOEX3 サイズ: 56 バイト(x86)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 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 : ADDRINFOEX3* (+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 も可)
; ai_interfaceindex : INT (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; ADDRINFOEX3 サイズ: 96 バイト(x64)
dim st, 24    ; 4byte整数×24(構造体サイズ 96 / 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 : ADDRINFOEX3* (+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,上位
; ai_interfaceindex : INT (+88, 4byte)  st.22 = 値  /  値 = st.22   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global ADDRINFOEX3
    #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
    #field int ai_interfaceindex
#endstruct

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