dnsGetApplicationSettings 函数 (windns.h)
检索每个应用程序的 DNS 设置。
语法
DWORD DnsGetApplicationSettings(
DWORD *pcServers,
DNS_CUSTOM_SERVER **ppDefaultServers,
DNS_APPLICATION_SETTINGS *pSettings
);
参数
pcServers
类型:_Out_ DWORD*
调用函数后,这将指向应用程序已配置的自定义 DNS 服务器数。 如果没有配置自定义服务器,或者函数失败,则此值将设置为 0。
ppDefaultServers
类型:_Outptr_result_buffer_ (*pcServers) DNS_CUSTOM_SERVER**
函数调用后,这将指向为应用程序配置的 DNS 自定义服务器数组。 如果应用程序未配置服务器,或者函数失败,则此值将设置为 NULL。
pSettings
类型:_Out_opt_ DNS_APPLICATION_SETTINGS*
指向 DNS_APPLICATION_SETTINGS 对象的指针,用应用程序设置填充。
返回值
包含成功时ERROR_SUCCESS或失败时包含错误代码的 DWORD。
注解
若要避免内存泄漏,必须在 DnsGetApplicationSettings 通过其 pSettings 参数返回的服务器上调用 DnsFreeCustomServers。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 内部版本 22000 |
最低受支持的服务器 | Windows 内部版本 22000 |
目标平台 | Windows |
标头 | windns.h |
Library | Dnsapi.lib |
DLL | Dnsapi.dll |