função DnsWriteQuestionToBuffer_UTF8 (windns.h)

Artigo
11/08/2024

O tipo de função DnsWriteQuestionToBuffer cria uma mensagem de consulta DNS e a armazena em uma estrutura de DNS_MESSAGE_BUFFER. Como muitas funções DNS, o tipo de função DnsWriteQuestionToBuffer é implementado em várias formas para facilitar a codificação de caracteres diferente. Com base na codificação de caracteres envolvida, use uma das seguintes funções:

DnsWriteQuestionToBuffer_W (_W para codificação Unicode)
DnsWriteQuestionToBuffer_UTF8 (_UTF8 para codificação UTF-8)

Se o tipo de função DnsWriteQuestionToBuffer for usado sem o sufixo (_W ou _UTF8), ocorrerá um erro do compilador.

Sintaxe

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

Um ponteiro para uma estrutura de DNS_MESSAGE_BUFFER que contém uma mensagem de consulta DNS armazenada em um buffer.

[in, out] pdwBufferSize

O tamanho, em bytes, do buffer alocado para armazenar pDnsBuffer. Se o tamanho do buffer for insuficiente para conter a mensagem, FALSE será retornado e pdwBufferSize conterá o tamanho mínimo do buffer necessário.

[in] pszName

Um ponteiro para uma cadeia de caracteres que representa o nome do proprietário do conjunto de registros que está sendo consultado.

[in] wType

Um valor que representa o tipo de registro DNS RR. wType determina o formato de Data. Por exemplo, se o valor de wType for DNS_TYPE_A, o tipo de dados de Data será DNS_A_DATA.

[in] Xid

Um valor que especifica o identificador de consulta DNS exclusivo.

[in] fRecursionDesired

Um BOOL que especifica se a consulta de nome recursivo deve ser usada pelo servidor de nomes DNS. Defina como TRUE para solicitar consulta de nome recursivo, FALSE para solicitar consulta de nome iterativo.

Valor de retorno

Retorna TRUE após a execução bem-sucedida, caso contrário, false.

Observações

A declaração a seguir para DnsWriteQuestionToBuffer_UTF8 pode ser encontrada em 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
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	windns.h
biblioteca	Dnsapi.lib
de DLL	Dnsapi.dll

Consulte também

DNS_MESSAGE_BUFFER

DNS_RECORD

DnsQuery

Compartilhar via