Funzione DnsQueryConfig (windns.h)

Articolo
01/16/2025

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 su cui eseguire query.

[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'adattatore su cui viene eseguita la query.

[in, optional] pReserved

Riservato per uso futuro.

[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 di Config.

parametro Config	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 specificato non è sufficiente, viene restituito un errore e pBufferLength contiene la dimensione minima necessaria del buffer. Ignorato nell'input se Flag è impostato su TRUE.

Valore restituito

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

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	windns.h
libreria	Dnsapi.lib
dll	Dnsapi.dll

Vedere anche

DNS_CONFIG_TYPE

DNS_RECORD

DnsQuery

Condividi tramite