fonction DnsWriteQuestionToBuffer_UTF8 (windns.h)
Le type de fonction DnsWriteQuestionToBuffer crée un message de requête DNS et le stocke dans une structure DNS_MESSAGE_BUFFER. Comme de nombreuses fonctions DNS, le type de fonction DnsWriteQuestionToBuffer 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 :
- DnsWriteQuestionToBuffer_W (_W pour l’encodage Unicode)
- DnsWriteQuestionToBuffer_UTF8 (_UTF8 pour l’encodage UTF-8)
Syntaxe
BOOL DnsWriteQuestionToBuffer_UTF8(
[in, out] PDNS_MESSAGE_BUFFER pDnsBuffer,
[in, out] PDWORD pdwBufferSize,
[in] PCSTR pszName,
[in] WORD wType,
[in] WORD Xid,
[in] BOOL fRecursionDesired
);
Paramètres
[in, out] pDnsBuffer
Pointeur vers une structure DNS_MESSAGE_BUFFER qui contient un message de requête DNS stocké dans une mémoire tampon.
[in, out] pdwBufferSize
Taille, en octets, de la mémoire tampon allouée pour stocker pDnsBuffer. Si la taille de la mémoire tampon est insuffisante pour contenir le message, FALSE est retournée et pdwBufferSize contient la taille minimale requise de la mémoire tampon.
[in] pszName
Pointeur vers une chaîne qui représente le nom du propriétaire du jeu d’enregistrements interrogé.
[in] wType
Valeur qui représente le type d’enregistrement DNS RR.
[in] Xid
Valeur qui spécifie l’identificateur de requête DNS unique.
[in] fRecursionDesired
BoOL qui spécifie si la requête de nom récursive doit être utilisée par le serveur de noms DNS. Défini sur TRUE pour demander une requête de nom récursif, FALSE pour demander une requête de nom itératif.
Valeur de retour
Retourne true lors de l’exécution réussie, sinon FALSE.
Remarques
La déclaration suivante pour DnsWriteQuestionToBuffer_UTF8 se trouve dans Windns.h.
BOOL
WINAPI
DnsWriteQuestionToBuffer_UTF8(
__inout PDNS_MESSAGE_BUFFER pDnsBuffer,
__inout PDWORD pdwBufferSize,
__in PCSTR pszName,
__in WORD wType,
__in WORD Xid,
__in BOOL fRecursionDesired
);
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 |