dnsQueryConfig 函式 (windns.h)
DnsQueryConfig函式可讓應用程式設計人員查詢本機電腦或特定配接器的設定。
語法
DNS_STATUS DnsQueryConfig(
[in] DNS_CONFIG_TYPE Config,
[in] DWORD Flag,
[in, optional] PCWSTR pwsAdapterName,
[in, optional] PVOID pReserved,
[out] PVOID pBuffer,
[in, out] PDWORD pBufLen
);
參數
[in] Config
DNS_CONFIG_TYPE值，指定要查詢之資訊的組態類型。
[in] Flag
值，指定是否要為組態資訊配置記憶體。 將 [旗標 ] 設定為 [DNS_CONFIG_FLAG_ALLOC ] 以配置記憶體;否則，請將它設定為 0。
注意 使用 LocalFree釋放配置的記憶體。
[in, optional] pwsAdapterName
字串的指標，表示執行查詢的配接器名稱。
[in, optional] pReserved
保留供未來使用。
[out] pBuffer
接收查詢回應之緩衝區的指標。 下表顯示每個 Config 參數值的緩衝區資料類型。
| Config 參數 | 緩衝區的資料類型 |
|---|---|
| DnsConfigPrimaryDomainName_W | PWCHAR |
| DnsConfigPrimaryDomainName_A | PCHAR |
| DnsConfigPrimaryDomainName_UTF8 | PCHAR |
| DnsConfigAdapterDomainName_W | 未實作 |
| DnsConfigAdapterDomainName_A | 未實作 |
| DnsConfigAdapterDomainName_UTF8 | 未實作 |
| DnsConfigDnsServerList | IP4_ARRAY |
| DnsConfigSearchList | 未實作 |
| DnsConfigAdapterInfo | 未實作 |
| DnsConfigPrimaryHostNameRegistrationEnabled | DWORD |
| DnsConfigAdapterHostNameRegistrationEnabled | DWORD |
| DnsConfigAddressRegistrationMaxCount | DWORD |
| DnsConfigHostName_W | PWCHAR |
| DnsConfigHostName_A | PCHAR |
| DnsConfigHostName_UTF8 | PCHAR |
| DnsConfigFullHostName_W | PWCHAR |
| DnsConfigFullHostName_A | PCHAR |
| DnsConfigFullHostName_UTF8 | PCHAR |
[in, out] pBufLen
緩衝區的長度，以位元組為單位。 如果提供的緩衝區不足，則會傳回錯誤，而 pBufferLength 包含必要的緩衝區大小下限。 如果 Flag 設定為 TRUE，則會忽略輸入。
傳回值
在成功完成時傳回成功確認。 否則，傳回 Winerror.h 中定義的適當 DNS 特定錯誤碼。
規格需求
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | windns.h |
| 程式庫 | Dnsapi.lib |
| Dll | Dnsapi.dll |