Функция DnsQueryConfig (windns.h)

Статья
08/27/2023

Функция 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 содержит минимальный необходимый размер буфера. Игнорируется при входных данных, если для флага задано значение TRUE.

Возвращаемое значение

Возвращает подтверждение успешного выполнения после успешного завершения. В противном случае возвращает соответствующий код ошибки ДЛЯ DNS, как определено в Winerror.h.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	windns.h
Библиотека	Dnsapi.lib
DLL	Dnsapi.dll

См. также раздел

DNS_CONFIG_TYPE

DNS_RECORD

DnsQuery

Поделиться через