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

Статья
01/16/2025

Функция 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

Указатель на буфер, получающий ответ запроса. В следующей таблице показан тип данных буфера для каждого из значений параметров конфигурации .

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

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	windns.h
библиотеки	Dnsapi.lib
DLL	Dnsapi.dll

См. также

DNS_CONFIG_TYPE

DNS_RECORD

DnsQuery

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