fonction DnsQuery_UTF8 (windns.h)
Le type de fonction DnsQuery est l’interface de requête générique de l’espace de noms DNS et fournit aux développeurs d’applications une interface de résolution de requête DNS. Comme de nombreuses fonctions DNS, le type de fonction DnsQuery est implémenté dans plusieurs formulaires pour faciliter l’encodage de caractères différent. En fonction de l’encodage de caractères impliqué, utilisez l’une des fonctions suivantes :
- DnsQuery_A (pour l’encodage ANSI)
- DnsQuery_W (pour l’encodage Unicode)
- DnsQuery_UTF8 (pour l’encodage UTF-8)
Syntaxe
DNS_STATUS DnsQuery_UTF8(
[in] PCSTR pszName,
[in] WORD wType,
[in] DWORD Options,
[in, out, optional] PVOID pExtra,
[out, optional] PDNS_RECORD *ppQueryResults,
[out, optional] PVOID *pReserved
);
Paramètres
[in] pszName
Pointeur vers une chaîne qui représente le nom DNS à interroger.
[in] wType
Valeur qui représente l’enregistrement de ressource (RR)type d’enregistrement DNS interrogé. wType détermine le format des données pointées par ppQueryResultsSet. Par exemple, si la valeur de wType est DNS_TYPE_A, le format des données pointées par ppQueryResultsSet est DNS_A_DATA.
[in] Options
Valeur qui contient une bitmap de options de requête DNS à utiliser dans la requête DNS. Les options peuvent être combinées et toutes les options remplacent DNS_QUERY_STANDARD.
[in, out, optional] pExtra
Ce paramètre est réservé pour une utilisation ultérieure et doit être défini sur NULL.
[out, optional] ppQueryResults
Optionnel. Pointeur vers un pointeur qui pointe vers la liste des RR qui composent la réponse. Pour plus d’informations, consultez la section Remarques.
[out, optional] pReserved
Ce paramètre est réservé pour une utilisation ultérieure et doit être défini sur NULL.
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.
Remarques
Les applications qui appellent la fonction DnsQuery créent une requête à l’aide d’un nom DNS complet et d’un type RR (Resource Record), puis définissent des options de requête en fonction du type de service souhaité. Lorsque l’option DNS_QUERY_STANDARD est définie, DNS utilise le cache du programme de résolution, les requêtes d’abord avec UDP, puis réessaye avec TCP si la réponse est tronquée et demande au serveur d’effectuer une résolution récursive au nom du client pour résoudre la requête.
Les applications doivent libérer les jeux RR retournés avec la fonction DnsRecordListFree.
Si le paramètre
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 |