Compartir a través de

función DnsWriteQuestionToBuffer_UTF8 (windns.h)

  • Artículo

El tipo de función DnsWriteQuestionToBuffer crea un mensaje de consulta DNS y lo almacena en una estructura de DNS_MESSAGE_BUFFER . Al igual que muchas funciones DNS, el tipo de función DnsWriteQuestionToBuffer se implementa en varios formularios para facilitar la codificación de caracteres diferente. En función de la codificación de caracteres implicada, use una de las siguientes funciones:

  • DnsWriteQuestionToBuffer_W (_W para la codificación Unicode)
  • DnsWriteQuestionToBuffer_UTF8 (_UTF8 para codificación UTF-8)
Si el tipo de función DnsWriteQuestionToBuffer se usa sin sufijo (ya sea _W o _UTF8), se producirá un error del compilador.

Sintaxis

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
);

Parámetros

[in, out] pDnsBuffer

Puntero a una estructura de DNS_MESSAGE_BUFFER que contiene un mensaje de consulta DNS almacenado en un búfer.

[in, out] pdwBufferSize

Tamaño, en bytes, del búfer asignado para almacenar pDnsBuffer. Si el tamaño del búfer no es suficiente para contener el mensaje, se devuelve FALSE y pdwBufferSize contiene el tamaño mínimo necesario del búfer.

[in] pszName

Puntero a una cadena que representa el nombre del propietario del conjunto de registros que se está consultando.

[in] wType

Valor que representa el tipo de registro DNS rr. wType determina el formato de Data. Por ejemplo, si el valor de wType es DNS_TYPE_A, el tipo de datos de Data se DNS_A_DATA.

[in] Xid

Valor que especifica el identificador de consulta DNS único.

[in] fRecursionDesired

BoOL que especifica si el servidor de nombres DNS debe usar una consulta de nombre recursiva. Establezca en TRUE para solicitar una consulta de nombre recursiva, FALSE para solicitar una consulta de nombre iterativa.

Valor devuelto

Devuelve TRUE tras la ejecución correcta; de lo contrario, FALSE.

Comentarios

La siguiente declaración para DnsWriteQuestionToBuffer_UTF8 se puede encontrar en 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
    );

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado windns.h
Library Dnsapi.lib
Archivo DLL Dnsapi.dll

Consulte también

DNS_MESSAGE_BUFFER

DNS_RECORD

DnsQuery