DnsQueryConfig, fonction (windns.h)

La fonction DnsQueryConfig permet aux programmeurs d’applications d’interroger la configuration de l’ordinateur local ou d’un adaptateur spécifique.

Syntaxe

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

Paramètres

[in] Config

Valeur DNS_CONFIG_TYPE qui spécifie le type de configuration des informations à interroger.

[in] Flag

Valeur qui spécifie s’il faut allouer de la mémoire pour les informations de configuration. Définissez Indicateursur DNS_CONFIG_FLAG_ALLOC pour allouer de la mémoire ; sinon, définissez-le sur 0.

Note Libérez la mémoire allouée avec LocalFree.
 

[in, optional] pwsAdapterName

Pointeur vers une chaîne qui représente le nom de l’adaptateur sur lequel la requête est exécutée.

[in, optional] pReserved

Réservé pour un usage futur.

[out] pBuffer

Pointeur vers une mémoire tampon qui reçoit la réponse à la requête. Le tableau suivant montre le type de données de la mémoire tampon pour chacune des valeurs de paramètre Config .

Paramètre de configuration Type de données de la mémoire tampon
DnsConfigPrimaryDomainName_W PWCHAR
DnsConfigPrimaryDomainName_A PCHAR
DnsConfigPrimaryDomainName_UTF8 PCHAR
DnsConfigAdapterDomainName_W Non implémenté
DnsConfigAdapterDomainName_A Non implémenté
DnsConfigAdapterDomainName_UTF8 Non implémenté
DnsConfigDnsServerList IP4_ARRAY
DnsConfigSearchList Non implémenté
DnsConfigAdapterInfo Non implémenté
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

Longueur de la mémoire tampon, en octets. Si la mémoire tampon fournie n’est pas suffisante, une erreur est retournée et pBufferLength contient la taille de mémoire tampon minimale nécessaire. Ignoré lors de l’entrée si l’indicateur est défini sur TRUE.

Valeur retournée

Retourne la confirmation de réussite en cas de réussite. Sinon, retourne le code d’erreur dns approprié tel que défini dans Winerror.h.

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête windns.h
Bibliothèque Dnsapi.lib
DLL Dnsapi.dll

Voir aussi

DNS_CONFIG_TYPE

DNS_RECORD

DnsQuery