FIXED_INFO_W2KSP1
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| HostName | CHAR | 132 | +0 | +0 | ローカルコンピューターのホスト名です。ドメインに参加しているコンピューターの場合、完全修飾ホスト名 (ドメインを含む) になることがあります。 | ||||||||||
| DomainName | CHAR | 132 | +132 | +132 | ローカルコンピューターが登録されているドメインです。 | ||||||||||
| CurrentDnsServer | IP_ADDR_STRING* | 8/4 | +264 | +264 | 予約済みです。ローカルコンピューターの DNS サーバーを取得するには、DnsServerList メンバーを使用してください。 | ||||||||||
| DnsServerList | IP_ADDR_STRING | 48/40 | +272 | +268 | ローカルコンピューターが使用する DNS サーバーの一覧を指定する IP_ADDR_STRING 構造体のリンクリストです。 | ||||||||||
| NodeType | DWORD | 4 | +320 | +308 | ローカルコンピューターのノードタイプです。これらの値は Iptypes.h ヘッダーファイルで定義されています。
| ||||||||||
| ScopeId | CHAR | 260 | +324 | +312 | DHCP スコープ名です。 | ||||||||||
| EnableRouting | DWORD | 4 | +584 | +572 | ローカルコンピューターでルーティングが有効かどうかを指定するブール値です。 | ||||||||||
| EnableProxy | DWORD | 4 | +588 | +576 | ローカルコンピューターが ARP プロキシとして動作しているかどうかを指定するブール値です。 | ||||||||||
| EnableDns | DWORD | 4 | +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 公式リファレンス: 英語 (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 Structureimport 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: uint32struct 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