Funzione DnsQueryConfig (windns.h)

Articolo
08/27/2023

La funzione DnsQueryConfig consente ai programmatori di applicazioni di eseguire query per la configurazione del computer locale o di una scheda specifica.

Sintassi

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
);

Parametri

[in] Config

Valore DNS_CONFIG_TYPE che specifica il tipo di configurazione delle informazioni da eseguire.

[in] Flag

Valore che specifica se allocare memoria per le informazioni di configurazione. Impostare Flag su DNS_CONFIG_FLAG_ALLOC per allocare memoria; in caso contrario, impostarlo su 0.

Nota Liberare la memoria allocata con LocalFree.

[in, optional] pwsAdapterName

Puntatore a una stringa che rappresenta il nome dell'adapter in base al quale viene eseguita la query.

[in, optional] pReserved

Riservato per utilizzi futuri.

[out] pBuffer

Puntatore a un buffer che riceve la risposta della query. Nella tabella seguente viene illustrato il tipo di dati del buffer per ognuno dei valori dei parametri Config .

Parametro di configurazione	Tipo di dati del buffer
DnsConfigPrimaryDomainName_W	PWCHAR
DnsConfigPrimaryDomainName_A	PCHAR
DnsConfigPrimaryDomainName_UTF8	PCHAR
DnsConfigAdapterDomainName_W	Non implementato
DnsConfigAdapterDomainName_A	Non implementato
DnsConfigAdapterDomainName_UTF8	Non implementato
DnsConfigDnsServerList	IP4_ARRAY
DnsConfigSearchList	Non implementato
DnsConfigAdapterInfo	Non implementato
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

Lunghezza del buffer, in byte. Se il buffer fornito non è sufficiente, viene restituito un errore e pBufferLength contiene le dimensioni minime necessarie del buffer. Ignorato nell'input se flag è impostato su TRUE.

Valore restituito

Restituisce la conferma dell'esito positivo al completamento positivo. In caso contrario, restituisce il codice di errore specifico del DNS appropriato come definito in Winerror.h.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	windns.h
Libreria	Dnsapi.lib
DLL	Dnsapi.dll

Vedi anche

DNS_CONFIG_TYPE

DNS_RECORD

DnsQuery

Condividi tramite