Fonction DnsQueryConfig (windns.h)

Article
01/16/2025

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 indicateur sur DNS_CONFIG_FLAG_ALLOC pour allouer de la mémoire ; sinon, définissez-le sur 0.

Remarque Libérer 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 une utilisation ultérieure.

[out] pBuffer

Pointeur vers une mémoire tampon qui reçoit la réponse de 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 Config	Type de 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 minimale nécessaire de la mémoire tampon. Ignoré lors de l’entrée si indicateur a la valeur TRUE.

Valeur de retour

Retourne la confirmation de réussite lors de la réussite. Sinon, retourne le code d’erreur propre au DNS approprié tel que défini dans Winerror.h.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	windns.h
bibliothèque	Dnsapi.lib
DLL	Dnsapi.dll

Voir aussi

DNS_CONFIG_TYPE

DNS_RECORD

DnsQuery

Partager via