Condividi tramite


Funzione DnsQueryConfig (windns.h)

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