DnsQueryConfig, fonction (windns.h)

Article
08/27/2023

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

Partager via