DNS_INTERFACE_SETTINGS
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| Version | DWORD | 4 | +0 | +0 | DNS_INTERFACE_SETTINGS_VERSION1 に設定されていなければなりません。 |
| Flags | ULONGLONG | 8 | +8 | +8 | 次のオプションのビットマップです。 DNS_SETTING_IPV6 (0x0001)。インターフェイス設定を IPv6 ネットワーク スタックに対してのみ構成します。このオプションが設定されている場合、NameServer メンバーまたは ProfileNameServer メンバーに指定する IP アドレスはすべて IPv6 アドレスでなければなりません。既定では、この構造体で指定した DNS インターフェイス設定は IPv4 ネットワーク スタックにのみ適用されます。 DNS_SETTING_NAMESERVER (0x0002)。NameServer メンバーを使用して、指定したインターフェイスに静的なアダプター DNS サーバーを構成します。 DNS_SETTING_SEARCHLIST (0x0004)。SearchList メンバーを使用して、指定したアダプターの接続固有の DNS サフィックス検索リストを構成します。 DNS_SETTING_REGISTRATION_ENABLED (0x0008)。指定したアダプターの動的 DNS 登録を有効または無効にします。これは既定でシステムによって有効にされています。 DNS_SETTING_DOMAIN (0x0020)。Domain メンバーを使用して、指定したアダプターの接続固有の DNS サフィックスを構成します。 DNS_SETTINGS_ENABLE_LLMNR (0x0080)。指定したアダプターでの LLMNR および mDNS を使用した名前解決を有効または無効にします。これは既定でシステムによって有効にされています。 DNS_SETTINGS_QUERY_ADAPTER_NAME (0x0100)。DNS クエリのサフィックスとしてアダプター名を使用するかどうかを有効または無効にします。これは既定でシステムによって有効にされています。 DNS_SETTING_PROFILE_NAMESERVER (0x0200)。ProfileNameServer メンバーを使用して、指定したインターフェイスに静的なプロファイル DNS サーバーを構成します。 |
| Domain | LPWSTR | 8/4 | +16 | +16 | アダプターのドメイン名を格納した、NULL で終わるワイド文字列です。 |
| NameServer | LPWSTR | 8/4 | +24 | +20 | コンマまたは空白で区切られた一連の DNS サーバーを格納した、NULL で終わるワイド文字列です。たとえば L"1.1.1.1 8.8.8.8" や L"1.1.1.1,8.8.8.8" のように指定します。 DNS_SETTING_IPV6 フラグが指定されている場合、これらのサーバーは IPv6 アドレスでなければなりません。たとえば L"2606:4700:4700::1001,2606:4700:4700::1111" のように指定します。 |
| SearchList | LPWSTR | 8/4 | +32 | +24 | コンマまたは空白で区切られた一連の検索名を格納した、NULL で終わるワイド文字列です。たとえば L"contoso1.com contoso2.com" や L"contoso1.com, contoso2.com" のように指定します。 |
| RegistrationEnabled | DWORD | 4 | +40 | +28 | アダプターの動的登録を有効にする場合は TRUE、無効にする場合は FALSE を指定します。 |
| RegisterAdapterName | DWORD | 4 | +44 | +32 | アダプター名の登録を有効にする場合は TRUE、無効にする場合は FALSE を指定します。 |
| EnableLLMNR | DWORD | 4 | +48 | +36 | 指定したインターフェイスで mDNS および LLMNR を有効にする場合は TRUE、無効にする場合は FALSE を指定します。 |
| QueryAdapterName | DWORD | 4 | +52 | +40 | アダプター名を検索サフィックスとして使用する場合は TRUE、それ以外の場合は FALSE を指定します。 |
| ProfileNameServer | LPWSTR | 8/4 | +56 | +44 | コンマまたは空白で区切られた一連の DNS サーバーを格納した、NULL で終わるワイド文字列です。たとえば L"1.1.1.1 8.8.8.8" や L"1.1.1.1,8.8.8.8" のように指定します。 DNS_SETTING_IPV6 フラグが指定されている場合、これらのサーバーは IPv6 アドレスでなければなりません。たとえば L"2606:4700:4700::1001,2606:4700:4700::1111" のように指定します。 |
公式ドキュメント
SetInterfaceDnsSettings 関数を呼び出して特定のインターフェイスに構成できる、または GetInterfaceDnsSettings 関数を呼び出して特定のインターフェイスから取得できる DNS 設定を表します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// DNS_INTERFACE_SETTINGS (x64 64 / x86 48 バイト)
typedef struct DNS_INTERFACE_SETTINGS {
DWORD Version;
ULONGLONG Flags;
LPWSTR Domain;
LPWSTR NameServer;
LPWSTR SearchList;
DWORD RegistrationEnabled;
DWORD RegisterAdapterName;
DWORD EnableLLMNR;
DWORD QueryAdapterName;
LPWSTR ProfileNameServer;
} DNS_INTERFACE_SETTINGS;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DNS_INTERFACE_SETTINGS
{
public uint Version;
public ulong Flags;
public IntPtr Domain;
public IntPtr NameServer;
public IntPtr SearchList;
public uint RegistrationEnabled;
public uint RegisterAdapterName;
public uint EnableLLMNR;
public uint QueryAdapterName;
public IntPtr ProfileNameServer;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DNS_INTERFACE_SETTINGS
Public Version As UInteger
Public Flags As ULong
Public Domain As IntPtr
Public NameServer As IntPtr
Public SearchList As IntPtr
Public RegistrationEnabled As UInteger
Public RegisterAdapterName As UInteger
Public EnableLLMNR As UInteger
Public QueryAdapterName As UInteger
Public ProfileNameServer As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class DNS_INTERFACE_SETTINGS(ctypes.Structure):
_fields_ = [
("Version", wintypes.DWORD),
("Flags", ctypes.c_ulonglong),
("Domain", ctypes.c_void_p),
("NameServer", ctypes.c_void_p),
("SearchList", ctypes.c_void_p),
("RegistrationEnabled", wintypes.DWORD),
("RegisterAdapterName", wintypes.DWORD),
("EnableLLMNR", wintypes.DWORD),
("QueryAdapterName", wintypes.DWORD),
("ProfileNameServer", ctypes.c_void_p),
]#[repr(C)]
pub struct DNS_INTERFACE_SETTINGS {
pub Version: u32,
pub Flags: u64,
pub Domain: *mut core::ffi::c_void,
pub NameServer: *mut core::ffi::c_void,
pub SearchList: *mut core::ffi::c_void,
pub RegistrationEnabled: u32,
pub RegisterAdapterName: u32,
pub EnableLLMNR: u32,
pub QueryAdapterName: u32,
pub ProfileNameServer: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type DNS_INTERFACE_SETTINGS struct {
Version uint32
Flags uint64
Domain uintptr
NameServer uintptr
SearchList uintptr
RegistrationEnabled uint32
RegisterAdapterName uint32
EnableLLMNR uint32
QueryAdapterName uint32
ProfileNameServer uintptr
}type
DNS_INTERFACE_SETTINGS = record
Version: DWORD;
Flags: UInt64;
Domain: Pointer;
NameServer: Pointer;
SearchList: Pointer;
RegistrationEnabled: DWORD;
RegisterAdapterName: DWORD;
EnableLLMNR: DWORD;
QueryAdapterName: DWORD;
ProfileNameServer: Pointer;
end;const DNS_INTERFACE_SETTINGS = extern struct {
Version: u32,
Flags: u64,
Domain: ?*anyopaque,
NameServer: ?*anyopaque,
SearchList: ?*anyopaque,
RegistrationEnabled: u32,
RegisterAdapterName: u32,
EnableLLMNR: u32,
QueryAdapterName: u32,
ProfileNameServer: ?*anyopaque,
};type
DNS_INTERFACE_SETTINGS {.bycopy.} = object
Version: uint32
Flags: uint64
Domain: pointer
NameServer: pointer
SearchList: pointer
RegistrationEnabled: uint32
RegisterAdapterName: uint32
EnableLLMNR: uint32
QueryAdapterName: uint32
ProfileNameServer: pointerstruct DNS_INTERFACE_SETTINGS
{
uint Version;
ulong Flags;
void* Domain;
void* NameServer;
void* SearchList;
uint RegistrationEnabled;
uint RegisterAdapterName;
uint EnableLLMNR;
uint QueryAdapterName;
void* ProfileNameServer;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DNS_INTERFACE_SETTINGS サイズ: 48 バイト(x86)
dim st, 12 ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; Version : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; Flags : ULONGLONG (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; Domain : LPWSTR (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; NameServer : LPWSTR (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; SearchList : LPWSTR (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; RegistrationEnabled : DWORD (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; RegisterAdapterName : DWORD (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; EnableLLMNR : DWORD (+36, 4byte) st.9 = 値 / 値 = st.9 (lpoke/lpeek も可)
; QueryAdapterName : DWORD (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; ProfileNameServer : LPWSTR (+44, 4byte) st.11 = 値 / 値 = st.11 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DNS_INTERFACE_SETTINGS サイズ: 64 バイト(x64)
dim st, 16 ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; Version : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; Flags : ULONGLONG (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; Domain : LPWSTR (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; NameServer : LPWSTR (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; SearchList : LPWSTR (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; RegistrationEnabled : DWORD (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; RegisterAdapterName : DWORD (+44, 4byte) st.11 = 値 / 値 = st.11 (lpoke/lpeek も可)
; EnableLLMNR : DWORD (+48, 4byte) st.12 = 値 / 値 = st.12 (lpoke/lpeek も可)
; QueryAdapterName : DWORD (+52, 4byte) st.13 = 値 / 値 = st.13 (lpoke/lpeek も可)
; ProfileNameServer : LPWSTR (+56, 8byte) qpoke st,56,値 / qpeek(st,56) ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DNS_INTERFACE_SETTINGS
#field int Version
#field int64 Flags
#field intptr Domain
#field intptr NameServer
#field intptr SearchList
#field int RegistrationEnabled
#field int RegisterAdapterName
#field int EnableLLMNR
#field int QueryAdapterName
#field intptr ProfileNameServer
#endstruct
stdim st, DNS_INTERFACE_SETTINGS ; NSTRUCT 変数を確保
st->Version = 100
mes "Version=" + st->Version