Compartilhar via

Função DnsWriteQuestionToBuffer_UTF8 (windns.h)

  • Artigo

O tipo de função DnsWriteQuestionToBuffer cria uma mensagem de consulta DNS e a armazena em uma estrutura 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 seu 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 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 Dados. Por exemplo, se o valor de wType for DNS_TYPE_A, o tipo de dados de Dados 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.

Retornar valor

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

Comentários

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
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho windns.h
Biblioteca Dnsapi.lib
DLL Dnsapi.dll

Confira também

DNS_MESSAGE_BUFFER

DNS_RECORD

DnsQuery