função DnsQuery_UTF8 (windns.h)
O tipo de função DnsQuery é a interface de consulta genérica para o namespace DNS e fornece aos desenvolvedores de aplicativos uma interface de resolução de consulta DNS. Como muitas funções DNS, o tipo de função DnsQuery é 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:
- DnsQuery_A (para codificação ANSI)
- DnsQuery_W (para codificação Unicode)
- DnsQuery_UTF8 (para codificação UTF-8)
Sintaxe
DNS_STATUS DnsQuery_UTF8(
[in] PCSTR pszName,
[in] WORD wType,
[in] DWORD Options,
[in, out, optional] PVOID pExtra,
[out, optional] PDNS_RECORD *ppQueryResults,
[out, optional] PVOID *pReserved
);
Parâmetros
[in] pszName
Um ponteiro para uma cadeia de caracteres que representa o nome DNS a ser consultado.
[in] wType
Um valor que representa o registro de recurso (RR) de tipo de registro DNS que é consultado. wType determina o formato dos dados apontados por ppQueryResultsSet. Por exemplo, se o valor de wType for DNS_TYPE_A, o formato dos dados apontados por ppQueryResultsSet será DNS_A_DATA.
[in] Options
Um valor que contém um bitmap de opções de consulta DNS a serem usadas na consulta DNS. As opções podem ser combinadas e todas as opções substituem DNS_QUERY_STANDARD.
[in, out, optional] pExtra
Esse parâmetro é reservado para uso futuro e deve ser definido como NULL.
[out, optional] ppQueryResults
Opcional. Um ponteiro para um ponteiro que aponta para a lista de RRs que compõem a resposta. Para obter mais informações, consulte a seção Comentários.
[out, optional] pReserved
Esse parâmetro é reservado para uso futuro e deve ser definido como NULL.
Valor de retorno
Retorna a confirmação de êxito após a conclusão bem-sucedida. Caso contrário, retorna o código de erro específico do DNS apropriado, conforme definido em Winerror.h.
Observações
Os aplicativos que chamam a função DnsQuery criam uma consulta usando um nome DNS totalmente qualificado e um tipo RR (Registro de Recurso) e definem opções de consulta dependendo do tipo de serviço desejado. Quando a opção DNS_QUERY_STANDARD é definida, o DNS usa o cache de resolvedor, consulta primeiro com UDP e, em seguida, tenta novamente com TCP se a resposta é truncada e solicita que o servidor execute resolução recursiva em nome do cliente para resolver a consulta.
Os aplicativos devem liberar conjuntos de RR retornados com a função DnsRecordListFree
Se o parâmetro
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 |