Win32 API 日本語リファレンス
ホームNetworkManagement.IpHelper › FIXED_INFO_W2KSP1

FIXED_INFO_W2KSP1

構造体
サイズx64: 600 バイト / x86: 584 バイト

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

フィールド

フィールドサイズx64x86説明
HostNameCHAR132+0+0ローカルコンピューターのホスト名です。ドメインに参加しているコンピューターの場合、完全修飾ホスト名 (ドメインを含む) になることがあります。
DomainNameCHAR132+132+132ローカルコンピューターが登録されているドメインです。
CurrentDnsServerIP_ADDR_STRING*8/4+264+264予約済みです。ローカルコンピューターの DNS サーバーを取得するには、DnsServerList メンバーを使用してください。
DnsServerListIP_ADDR_STRING48/40+272+268ローカルコンピューターが使用する DNS サーバーの一覧を指定する IP_ADDR_STRING 構造体のリンクリストです。
NodeTypeDWORD4+320+308

ローカルコンピューターのノードタイプです。これらの値は Iptypes.h ヘッダーファイルで定義されています。

NodeType 意味
BROADCAST_NODETYPE
0x0001
ブロードキャストノードタイプです。
PEER_TO_PEER_NODETYPE
0x0002
ピアツーピアノードタイプです。
MIXED_NODETYPE
0x0004
混合 (mixed) ノードタイプです。
HYBRID_NODETYPE
0x0008
ハイブリッドノードタイプです。
ScopeIdCHAR260+324+312DHCP スコープ名です。
EnableRoutingDWORD4+584+572ローカルコンピューターでルーティングが有効かどうかを指定するブール値です。
EnableProxyDWORD4+588+576ローカルコンピューターが ARP プロキシとして動作しているかどうかを指定するブール値です。
EnableDnsDWORD4+592+580ローカルコンピューターで DNS が有効かどうかを指定するブール値です。

公式ドキュメント

FIXED_INFO 構造体には、コンピューター上のすべてのインターフェイスで共通の情報が格納されます。

解説(Remarks)

FIXED_INFO 構造体は、GetNetworkParams 関数によって取得されます。

Microsoft Windows ソフトウェア開発キット (SDK) では、FIXED_INFO_WIN2KSP1 構造体が定義されています。アプリケーションのコンパイル時に、対象プラットフォームが Windows 2000 Service Pack 1 (SP1) 以降 (NTDDI_VERSION >= NTDDI_WIN2KSP1_WIN32_WINNT >= 0x0501、または WINVER >= 0x0501) の場合、FIXED_INFO_WIN2KSP1 構造体は FIXED_INFO 構造体に typedef されます。対象プラットフォームが Windows 2000 SP1 以降でない場合、 FIXED_INFO 構造体は未定義です。

GetNetworkParams 関数と FIXED_INFO 構造体は、Windows 98 以降でサポートされます。ただし、Windows 2000 Service Pack 1 (SP1) より前の対象プラットフォーム向けにアプリケーションをビルドするには、以前のバージョンの Platform Software Development Kit (SDK) を使用する必要があります。

次のコードは、ローカルコンピューターのネットワーク構成情報を格納した FIXED_INFO 構造体を取得します。このコードは、構造体から選択したメンバーを出力します。

//
// Link with IPHlpAPI.lib
//
#include <winsock2.h>
#include <iphlpapi.h>
#include <stdio.h>
#include <windows.h>
#pragma comment(lib, "IPHLPAPI.lib")

#define MALLOC(x) HeapAlloc(GetProcessHeap(), 0, (x))
#define FREE(x) HeapFree(GetProcessHeap(), 0, (x))

/* Note: could also use malloc() and free() */

int __cdecl main()
{

    FIXED_INFO *pFixedInfo;
    ULONG ulOutBufLen;
    DWORD dwRetVal;
    IP_ADDR_STRING *pIPAddr;

    pFixedInfo = (FIXED_INFO *) MALLOC(sizeof (FIXED_INFO));
    if (pFixedInfo == NULL) {
        printf("Error allocating memory needed to call GetNetworkParams\n");
        return 1;
    }
    ulOutBufLen = sizeof (FIXED_INFO);

// Make an initial call to GetAdaptersInfo to get
// the necessary size into the ulOutBufLen variable
    if (GetNetworkParams(pFixedInfo, &ulOutBufLen) == ERROR_BUFFER_OVERFLOW) {
        FREE(pFixedInfo);
        pFixedInfo = (FIXED_INFO *) MALLOC(ulOutBufLen);
        if (pFixedInfo == NULL) {
            printf("Error allocating memory needed to call GetNetworkParams\n");
            return 1;
        }
    }

    if (dwRetVal = GetNetworkParams(pFixedInfo, &ulOutBufLen) == NO_ERROR) {

        printf("Host Name: %s\n", pFixedInfo->HostName);
        printf("Domain Name: %s\n", pFixedInfo->DomainName);

        printf("DNS Servers:\n");
        printf("\t%s\n", pFixedInfo->DnsServerList.IpAddress.String);

        pIPAddr = pFixedInfo->DnsServerList.Next;
        while (pIPAddr) {
            printf("\t%s\n", pIPAddr->IpAddress.String);
            pIPAddr = pIPAddr->Next;
        }

        printf("Node Type: ");
        switch (pFixedInfo->NodeType) {
        case BROADCAST_NODETYPE:
            printf("Broadcast node\n");
            break;
        case PEER_TO_PEER_NODETYPE:
            printf("Peer to Peer node\n");
            break;
        case MIXED_NODETYPE:
            printf("Mixed node\n");
            break;
        case HYBRID_NODETYPE:
            printf("Hybrid node\n");
            break;
        default:
            printf("Unknown node type %0lx\n", pFixedInfo->NodeType);
            break;
        }

        printf("DHCP scope name: %s\n", pFixedInfo->ScopeId);

        if (pFixedInfo->EnableRouting)
            printf("Routing: enabled\n");
        else
            printf("Routing: disabled\n");

        if (pFixedInfo->EnableProxy)
            printf("ARP proxy: enabled\n");
        else
            printf("ARP Proxy: disabled\n");

        if (pFixedInfo->EnableDns)
            printf("DNS: enabled\n");
        else
            printf("DNS: disabled\n");

    } else {
        printf("GetNetworkParams failed with error: %d\n", dwRetVal);
        return 1;
    }

    if (pFixedInfo)
        FREE(pFixedInfo);

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

各言語での定義

#include <windows.h>

// IP_ADDRESS_STRING  (x64 16 / x86 16 バイト)
typedef struct IP_ADDRESS_STRING {
    CHAR String[16];
} IP_ADDRESS_STRING;

// IP_ADDR_STRING  (x64 48 / x86 40 バイト)
typedef struct IP_ADDR_STRING {
    IP_ADDR_STRING* Next;
    IP_ADDRESS_STRING IpAddress;
    IP_ADDRESS_STRING IpMask;
    DWORD Context;
} IP_ADDR_STRING;

// FIXED_INFO_W2KSP1  (x64 600 / x86 584 バイト)
typedef struct FIXED_INFO_W2KSP1 {
    CHAR HostName[132];
    CHAR DomainName[132];
    IP_ADDR_STRING* CurrentDnsServer;
    IP_ADDR_STRING DnsServerList;
    DWORD NodeType;
    CHAR ScopeId[260];
    DWORD EnableRouting;
    DWORD EnableProxy;
    DWORD EnableDns;
} FIXED_INFO_W2KSP1;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct IP_ADDRESS_STRING
{
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 16)] public sbyte[] String;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct IP_ADDR_STRING
{
    public IntPtr Next;
    public IP_ADDRESS_STRING IpAddress;
    public IP_ADDRESS_STRING IpMask;
    public uint Context;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FIXED_INFO_W2KSP1
{
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 132)] public sbyte[] HostName;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 132)] public sbyte[] DomainName;
    public IntPtr CurrentDnsServer;
    public IP_ADDR_STRING DnsServerList;
    public uint NodeType;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 260)] public sbyte[] ScopeId;
    public uint EnableRouting;
    public uint EnableProxy;
    public uint EnableDns;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure IP_ADDRESS_STRING
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=16)> Public String() As SByte
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure IP_ADDR_STRING
    Public Next As IntPtr
    Public IpAddress As IP_ADDRESS_STRING
    Public IpMask As IP_ADDRESS_STRING
    Public Context As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FIXED_INFO_W2KSP1
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=132)> Public HostName() As SByte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=132)> Public DomainName() As SByte
    Public CurrentDnsServer As IntPtr
    Public DnsServerList As IP_ADDR_STRING
    Public NodeType As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=260)> Public ScopeId() As SByte
    Public EnableRouting As UInteger
    Public EnableProxy As UInteger
    Public EnableDns As UInteger
End Structure
import ctypes
from ctypes import wintypes

class IP_ADDRESS_STRING(ctypes.Structure):
    _fields_ = [
        ("String", ctypes.c_byte * 16),
    ]

class IP_ADDR_STRING(ctypes.Structure):
    _fields_ = [
        ("Next", ctypes.c_void_p),
        ("IpAddress", IP_ADDRESS_STRING),
        ("IpMask", IP_ADDRESS_STRING),
        ("Context", wintypes.DWORD),
    ]

class FIXED_INFO_W2KSP1(ctypes.Structure):
    _fields_ = [
        ("HostName", ctypes.c_byte * 132),
        ("DomainName", ctypes.c_byte * 132),
        ("CurrentDnsServer", ctypes.c_void_p),
        ("DnsServerList", IP_ADDR_STRING),
        ("NodeType", wintypes.DWORD),
        ("ScopeId", ctypes.c_byte * 260),
        ("EnableRouting", wintypes.DWORD),
        ("EnableProxy", wintypes.DWORD),
        ("EnableDns", wintypes.DWORD),
    ]
#[repr(C)]
pub struct IP_ADDRESS_STRING {
    pub String: [i8; 16],
}

#[repr(C)]
pub struct IP_ADDR_STRING {
    pub Next: *mut core::ffi::c_void,
    pub IpAddress: IP_ADDRESS_STRING,
    pub IpMask: IP_ADDRESS_STRING,
    pub Context: u32,
}

#[repr(C)]
pub struct FIXED_INFO_W2KSP1 {
    pub HostName: [i8; 132],
    pub DomainName: [i8; 132],
    pub CurrentDnsServer: *mut core::ffi::c_void,
    pub DnsServerList: IP_ADDR_STRING,
    pub NodeType: u32,
    pub ScopeId: [i8; 260],
    pub EnableRouting: u32,
    pub EnableProxy: u32,
    pub EnableDns: u32,
}
import "golang.org/x/sys/windows"

type IP_ADDRESS_STRING struct {
	String [16]int8
}

type IP_ADDR_STRING struct {
	Next uintptr
	IpAddress IP_ADDRESS_STRING
	IpMask IP_ADDRESS_STRING
	Context uint32
}

type FIXED_INFO_W2KSP1 struct {
	HostName [132]int8
	DomainName [132]int8
	CurrentDnsServer uintptr
	DnsServerList IP_ADDR_STRING
	NodeType uint32
	ScopeId [260]int8
	EnableRouting uint32
	EnableProxy uint32
	EnableDns uint32
}
type
  IP_ADDRESS_STRING = record
    String: array[0..15] of Shortint;
  end;

  IP_ADDR_STRING = record
    Next: Pointer;
    IpAddress: IP_ADDRESS_STRING;
    IpMask: IP_ADDRESS_STRING;
    Context: DWORD;
  end;

  FIXED_INFO_W2KSP1 = record
    HostName: array[0..131] of Shortint;
    DomainName: array[0..131] of Shortint;
    CurrentDnsServer: Pointer;
    DnsServerList: IP_ADDR_STRING;
    NodeType: DWORD;
    ScopeId: array[0..259] of Shortint;
    EnableRouting: DWORD;
    EnableProxy: DWORD;
    EnableDns: DWORD;
  end;
const IP_ADDRESS_STRING = extern struct {
    String: [16]i8,
};

const IP_ADDR_STRING = extern struct {
    Next: ?*anyopaque,
    IpAddress: IP_ADDRESS_STRING,
    IpMask: IP_ADDRESS_STRING,
    Context: u32,
};

const FIXED_INFO_W2KSP1 = extern struct {
    HostName: [132]i8,
    DomainName: [132]i8,
    CurrentDnsServer: ?*anyopaque,
    DnsServerList: IP_ADDR_STRING,
    NodeType: u32,
    ScopeId: [260]i8,
    EnableRouting: u32,
    EnableProxy: u32,
    EnableDns: u32,
};
type
  IP_ADDRESS_STRING {.bycopy.} = object
    String: array[16, int8]

  IP_ADDR_STRING {.bycopy.} = object
    Next: pointer
    IpAddress: IP_ADDRESS_STRING
    IpMask: IP_ADDRESS_STRING
    Context: uint32

  FIXED_INFO_W2KSP1 {.bycopy.} = object
    HostName: array[132, int8]
    DomainName: array[132, int8]
    CurrentDnsServer: pointer
    DnsServerList: IP_ADDR_STRING
    NodeType: uint32
    ScopeId: array[260, int8]
    EnableRouting: uint32
    EnableProxy: uint32
    EnableDns: uint32
struct IP_ADDRESS_STRING
{
    byte[16] String;
}

struct IP_ADDR_STRING
{
    void* Next;
    IP_ADDRESS_STRING IpAddress;
    IP_ADDRESS_STRING IpMask;
    uint Context;
}

struct FIXED_INFO_W2KSP1
{
    byte[132] HostName;
    byte[132] DomainName;
    void* CurrentDnsServer;
    IP_ADDR_STRING DnsServerList;
    uint NodeType;
    byte[260] ScopeId;
    uint EnableRouting;
    uint EnableProxy;
    uint EnableDns;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; FIXED_INFO_W2KSP1 サイズ: 584 バイト(x86)
dim st, 146    ; 4byte整数×146(構造体サイズ 584 / 4 切り上げ)
; HostName : CHAR (+0, 132byte)  varptr(st)+0 を基点に操作(132byte:入れ子/配列)
; DomainName : CHAR (+132, 132byte)  varptr(st)+132 を基点に操作(132byte:入れ子/配列)
; CurrentDnsServer : IP_ADDR_STRING* (+264, 4byte)  varptr(st)+264 を基点に操作(4byte:入れ子/配列)
; DnsServerList : IP_ADDR_STRING (+268, 40byte)  varptr(st)+268 を基点に操作(40byte:入れ子/配列)
; NodeType : DWORD (+308, 4byte)  st.77 = 値  /  値 = st.77   (lpoke/lpeek も可)
; ScopeId : CHAR (+312, 260byte)  varptr(st)+312 を基点に操作(260byte:入れ子/配列)
; EnableRouting : DWORD (+572, 4byte)  st.143 = 値  /  値 = st.143   (lpoke/lpeek も可)
; EnableProxy : DWORD (+576, 4byte)  st.144 = 値  /  値 = st.144   (lpoke/lpeek も可)
; EnableDns : DWORD (+580, 4byte)  st.145 = 値  /  値 = st.145   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; FIXED_INFO_W2KSP1 サイズ: 600 バイト(x64)
dim st, 150    ; 4byte整数×150(構造体サイズ 600 / 4 切り上げ)
; HostName : CHAR (+0, 132byte)  varptr(st)+0 を基点に操作(132byte:入れ子/配列)
; DomainName : CHAR (+132, 132byte)  varptr(st)+132 を基点に操作(132byte:入れ子/配列)
; CurrentDnsServer : IP_ADDR_STRING* (+264, 8byte)  varptr(st)+264 を基点に操作(8byte:入れ子/配列)
; DnsServerList : IP_ADDR_STRING (+272, 48byte)  varptr(st)+272 を基点に操作(48byte:入れ子/配列)
; NodeType : DWORD (+320, 4byte)  st.80 = 値  /  値 = st.80   (lpoke/lpeek も可)
; ScopeId : CHAR (+324, 260byte)  varptr(st)+324 を基点に操作(260byte:入れ子/配列)
; EnableRouting : DWORD (+584, 4byte)  st.146 = 値  /  値 = st.146   (lpoke/lpeek も可)
; EnableProxy : DWORD (+588, 4byte)  st.147 = 値  /  値 = st.147   (lpoke/lpeek も可)
; EnableDns : DWORD (+592, 4byte)  st.148 = 値  /  値 = st.148   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global IP_ADDRESS_STRING
    #field byte String 16
#endstruct

#defstruct global IP_ADDR_STRING
    #field intptr Next
    #field IP_ADDRESS_STRING IpAddress
    #field IP_ADDRESS_STRING IpMask
    #field int Context
#endstruct

#defstruct global FIXED_INFO_W2KSP1
    #field byte HostName 132
    #field byte DomainName 132
    #field intptr CurrentDnsServer
    #field IP_ADDR_STRING DnsServerList
    #field int NodeType
    #field byte ScopeId 260
    #field int EnableRouting
    #field int EnableProxy
    #field int EnableDns
#endstruct

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