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

DNS_INTERFACE_SETTINGS

構造体
サイズx64: 64 バイト / x86: 48 バイト

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

フィールド

フィールドサイズx64x86説明
VersionDWORD4+0+0DNS_INTERFACE_SETTINGS_VERSION1 に設定されていなければなりません。
FlagsULONGLONG8+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 サーバーを構成します。

DomainLPWSTR8/4+16+16アダプターのドメイン名を格納した、NULL で終わるワイド文字列です。
NameServerLPWSTR8/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" のように指定します。

SearchListLPWSTR8/4+32+24コンマまたは空白で区切られた一連の検索名を格納した、NULL で終わるワイド文字列です。たとえば L"contoso1.com contoso2.com" や L"contoso1.com, contoso2.com" のように指定します。
RegistrationEnabledDWORD4+40+28アダプターの動的登録を有効にする場合は TRUE、無効にする場合は FALSE を指定します。
RegisterAdapterNameDWORD4+44+32アダプター名の登録を有効にする場合は TRUE、無効にする場合は FALSE を指定します。
EnableLLMNRDWORD4+48+36指定したインターフェイスで mDNS および LLMNR を有効にする場合は TRUE、無効にする場合は FALSE を指定します。
QueryAdapterNameDWORD4+52+40アダプター名を検索サフィックスとして使用する場合は TRUE、それ以外の場合は FALSE を指定します。
ProfileNameServerLPWSTR8/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 の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
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 Structure
import 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: pointer
struct 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