función DnsWriteQuestionToBuffer_UTF8 (windns.h)

Artículo
11/08/2024

El tipo de función DnsWriteQuestionToBu ffer 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 funciones siguientes:

DnsWriteQuestionToBuffer_W (_W para la codificación Unicode)
DnsWriteQuestionToBuffer_UTF8 (_UTF8 para codificación UTF-8)

Si se usa el tipo de función DnsWriteQuestionToBuffer 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 consulta.

[in] wType

Valor que representa el tipo de registro DNS de RR . wType determina el formato de Data. Por ejemplo, si el valor de wType es DNS_TYPE_A, el tipo de datos de Data es 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 recursivo, FALSE para solicitar una consulta de nombre iterativa.

Valor devuelto

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

Observaciones

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	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	windns.h
biblioteca de	Dnsapi.lib
DLL de	Dnsapi.dll

Consulte también

DNS_MESSAGE_BUFFER

DNS_RECORD

dnsQuery

Compartir a través de