fonction DnsWriteQuestionToBuffer_UTF8 (windns.h)

Article
03/04/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é sous 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)

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

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 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 minimale de mémoire tampon 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 la valeur TRUE pour demander une requête de nom récursif et 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

Condition requise	Valeur
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_MESSAGE_BUFFER

DNS_RECORD

DnsQuery

Partager via