Função GetTeredoPort (netioapi.h)

  • Artigo

A função GetTeredoPort recupera o número de porta UDP dinâmico usado pelo cliente Teredo no computador local.

Sintaxe

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetTeredoPort(
  [out] USHORT *Port
);

Parâmetros

[out] Port

Um ponteiro para o número da porta UDP. No retorno bem-sucedido, esse parâmetro será preenchido com o número da porta usado pelo cliente Teredo.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro.

Código de retorno Descrição
ERROR_INVALID_PARAMETER
 Um parâmetro inválido foi passado para a função. Esse erro será retornado se um ponteiro NULL for passado no parâmetro Port .
ERROR_NOT_READY
 O dispositivo não está pronto. Esse erro será retornado se o cliente Teredo não for iniciado no computador local.
ERROR_NOT_SUPPORTED
 A solicitação não terá suporte. Esse erro será retornado se nenhuma pilha IPv6 estiver no computador local.
Outros
 Use FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado.

Comentários

A função GetTeredoPort é definida no Windows Vista e posterior.

A função GetTeredoPort recupera o número da porta UDP atual usado pelo cliente Teredo para a porta de serviço do Teredo. A porta Teredo é dinâmica e pode mudar sempre que o cliente Teredo é reiniciado no computador local. Um aplicativo pode se registrar para ser notificado quando a porta de serviço do Teredo for alterada chamando a função NotifyTeredoPortChange .

O cliente Teredo também usa a porta UDP estática 3544 para escutar o tráfego multicast enviado no endereço IPv4 multicast 224.0.0.253, conforme definido no RFC 4380. Para obter mais informações, consulte http://www.ietf.org/rfc/rfc4380.txt.

A função GetTeredoPort é usada principalmente por aplicativos de firewall para configurar as exceções apropriadas para permitir o tráfego teredo de entrada e saída.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho netioapi.h (inclua Iphlpapi.h)
Biblioteca Iphlpapi.lib
DLL Iphlpapi.dll

Confira também

NotifyStableUnicastIpAddressTable

NotifyTeredoPortChange