fonction DnsWriteQuestionToBuffer_W (windns.h)

Article
11/08/2024

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)

Si le type de fonction DnsWriteQuestionToBuffer est utilisé sans son suffixe (_W ou _UTF8), une erreur du compilateur se produit.

Syntaxe

BOOL DnsWriteQuestionToBuffer_W(
  [in, out] PDNS_MESSAGE_BUFFER pDnsBuffer,
  [in, out] PDWORD              pdwBufferSize,
  [in]      PCWSTR              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. wType détermine le format dude données . Par exemple, si la valeur de wType est DNS_TYPE_A, le type de données Data est DNS_A_DATA.

[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

Voir aussi

DNS_MESSAGE_BUFFER

DNS_RECORD

DnsQuery

Partager via