共用方式為

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 參數 緩衝區的數據類型
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 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 windns.h
連結庫 Dnsapi.lib
DLL Dnsapi.dll

另請參閱

DNS_CONFIG_TYPE

DNS_RECORD

DnsQuery