Windows-rs项目中使用GetInterfaceDnsSettings获取DNS接口设置详解

在Windows系统编程中，获取网络适配器的DNS配置信息是一个常见需求。微软提供的windows-rs项目为Rust开发者提供了访问Windows API的能力。本文将深入探讨如何使用windows-rs中的GetInterfaceDnsSettings函数来获取DNS接口设置，特别是针对DNS over HTTPS(DOH)配置的获取。

DNS_INTERFACE_SETTINGS结构体版本

Windows系统提供了多个版本的DNS_INTERFACE_SETTINGS结构体，用于表示不同时期的DNS接口设置。最新版本是DNS_INTERFACE_SETTINGS3，它包含了DNS over HTTPS相关的配置信息。

结构体版本通过Version字段标识：

• DNS_INTERFACE_SETTINGS_VERSION1
• DNS_INTERFACE_SETTINGS_VERSION2
• DNS_INTERFACE_SETTINGS_VERSION3

正确使用GetInterfaceDnsSettings

GetInterfaceDnsSettings函数声明接收的是DNS_INTERFACE_SETTINGS指针，但实际上它可以根据Version字段识别不同版本的结构体。这是Windows API常见的版本兼容设计模式。

在Rust中正确使用该API需要注意以下几点：

1. 初始化结构体时必须设置正确的Version字段
2. 需要进行指针类型转换
3. 需要确保GUID参数正确获取

示例代码解析

以下是获取DNS接口设置的完整示例代码：

use windows::{core::*, Win32::NetworkManagement::IpHelper::*};

fn get_dns_settings(guid: GUID) -> Result<()> {
    // 初始化DNS_INTERFACE_SETTINGS3结构体
    let mut settings = DNS_INTERFACE_SETTINGS3 {
        Version: DNS_INTERFACE_SETTINGS_VERSION3,  // 必须设置版本号
        ..Default::default()
    };

    // 调用API，注意指针类型转换
    unsafe { 
        GetInterfaceDnsSettings(guid, &mut settings as *mut _ as _).ok()? 
    };
    
    // 检查DNS over HTTPS设置
    if settings.cServerProperties > 0 {
        println!("DNS over HTTPS已配置");
    } else {
        println!("未配置DNS over HTTPS");
    }
    
    Ok(())
}

常见问题排查

1. cServerProperties始终为0：这可能是因为DNS over HTTPS没有正确配置在网卡上，而是配置在了特定网络配置中。需要确保在Windows设置中为指定网络适配器配置了DOH。

2. GUID获取问题：需要先通过GetAdaptersAddresses获取适配器信息，然后将LUID转换为GUID。

3. 版本不匹配：确保结构体的Version字段与使用的结构体版本一致，否则可能导致数据解析错误。

最佳实践建议

1. 总是检查API调用的返回值
2. 使用unsafe块隔离不安全的指针操作
3. 在调试时打印完整结构体内容以验证数据
4. 考虑不同Windows版本可能的行为差异

通过正确使用windows-rs提供的这些API，开发者可以构建强大的网络配置管理工具，实现包括DNS over HTTPS在内的现代网络功能检测和配置。