nl :: Inet :: AsyncDNSResolverSockets

#include <src/inet/AsyncDNSResolverSockets.h>

Esta é uma classe interna para InetLayer que fornece APIs auxiliares para resolução de DNS (Asynchronous Domain Name System) em InetLayer .

Resumo

Não há interface pública disponível para a camada de aplicativo.

Funções públicas
`Cancel ( DNSResolver & resolver)`	`INET_ERROR` Cancele uma consulta DNS pendente que ainda pode estar ativa.
`EnqueueRequest ( DNSResolver & resolver)`	`INET_ERROR` Enfileirar um objeto DNSResolver para resolução de endereço IP assíncrona de um nome de host especificado.
`Init ( InetLayer *inet)`	`INET_ERROR` O inicializador explícito para a classe AsynchronousDNSResolverSockets.
`PrepareDNSResolver ( DNSResolver & resolver, const char hostName, uint16_t hostNameLen, uint8_t options, uint8_t maxAddrs, IPAddress addrArray, DNSResolver::OnResolveCompleteFunct onComplete, void *appState)`	`INET_ERROR` Este método prepara um objeto DNSResolver antes da resolução assíncrona.
`Shutdown (void)`	`INET_ERROR` Este é o desinicializador explícito da classe AsyncDNSResolverSockets e se encarrega de desligar os threads e destruir as variáveis mutex e semáforo.

Funções públicas

Cancelar

INET_ERROR Cancel(
  DNSResolver & resolver
)

Cancele uma consulta DNS pendente que ainda possa estar ativa.

Detalhes

Parâmetros

[in] resolver

Uma referência ao objeto DNSResolver .

EnqueueRequest

INET_ERROR EnqueueRequest(
  DNSResolver & resolver
)

Enfileirar um objeto DNSResolver para resolução de endereço IP assíncrona de um nome de host especificado.

Detalhes

Parâmetros

[in] resolver

Uma referência ao objeto DNSResolver .

Valores Retornados

`INET_NO_ERROR`	se uma solicitação DNS for enfileirada com sucesso.
`INET_ERROR_NO_MEMORY`	se o pool de resolução da camada Inet estiver cheio.
`other`	rede POSIX apropriada ou erro do sistema operacional.

Iniciar

INET_ERROR Init(
  InetLayer *inet
)

O inicializador explícito para a classe AsynchronousDNSResolverSockets.

Isso inicializa as variáveis mutex e semáforo e cria os threads para lidar com a resolução DNS assíncrona.

Detalhes

Parâmetros

[in] aInet

Um ponteiro para o objeto InetLayer .

Valores Retornados

`INET_NO_ERROR`	se a inicialização for bem-sucedida.
`other`	rede POSIX apropriada ou erro do sistema operacional.

PrepareDNSResolver

INET_ERROR PrepareDNSResolver(
  DNSResolver & resolver,
  const char *hostName,
  uint16_t hostNameLen,
  uint8_t options,
  uint8_t maxAddrs,
  IPAddress *addrArray,
  DNSResolver::OnResolveCompleteFunct onComplete,
  void *appState
)

Este método prepara um objeto DNSResolver antes da resolução assíncrona.

Detalhes

Parâmetros

`[in] resolver`	Uma referência a um objeto DNSResolver alocado.
`[in] hostName`	Um ponteiro para uma string C que representa o nome do host a ser consultado.
`[in] hostNameLen`	O comprimento da string do nome do host.
`[in] options`	Um valor inteiro que controla como a resolução do endereço do nome do host é executada. Os valores são da enumeração #DNSOptions.
`[in] maxAddrs`	O número máximo de endereços a serem armazenados na tabela DNS.
`[in] addrArray`	Um ponteiro para a tabela DNS.
`[in] onComplete`	Um ponteiro para a função de retorno de chamada quando uma solicitação DNS é concluída.
`[in] appState`	Um ponteiro para o estado do aplicativo a ser passado para onComplete quando uma solicitação DNS for concluída.

Valores Retornados

INET_NO_ERROR

se uma solicitação DNS for tratada com sucesso.

Desligar

INET_ERROR Shutdown(
  void
)

Este é o desinicializador explícito da classe AsyncDNSResolverSockets e se encarrega de desligar as threads e destruir as variáveis mutex e semáforo.

Detalhes

Valores Retornados

`INET_NO_ERROR`	se o desligamento for bem-sucedido.
`other`	rede POSIX apropriada ou erro do sistema operacional.