DnsWriteQuestionToBuffer_W, fonction (windns.h)

Le type de fonction DnsWriteQuestionToBuffer crée un message de requête DNS et le stocke dans une structure de DNS_MESSAGE_BUFFER . Comme de nombreuses fonctions DNS, le type de fonction DnsWriteQuestionToBuffer est implémenté dans plusieurs formes pour faciliter l’encodage de caractères différents. 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_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 de 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é et pdwBufferSize contient la taille de mémoire tampon minimale requise.

[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 des 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écursif doit être utilisée par le serveur de noms DNS. Définissez sur TRUE pour demander une requête de nom récursif, FALSE pour demander une requête de nom itérative.

Valeur retournée

Retourne TRUE en cas d’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
    );

Configuration requise

Voir aussi

DNS_MESSAGE_BUFFER

DNS_RECORD

DnsQuery