Compartilhar via

Função GetTeredoPort

  • Artigo

A função GetTeredoPort recupera o número da porta UDP dinâmica que o cliente Teredo usa em um computador local.

Sintaxe

NETIOAPI_API GetTeredoPort(
  _Out_ USHORT *Port
);

Parâmetros

  • Porta [out]
    Um ponteiro para o número da porta UDP. No retorno bem-sucedido, esse parâmetro é preenchido com o número da porta que o cliente Teredo usa.

Valor retornado

GetTeredoPort retorna STATUS_SUCCESS se a função for bem-sucedida.

Se a função falhar, GetTeredoPort retorna um dos seguintes códigos de erro:

Código de retorno Descrição
STATUS_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.
STATUS_NOT_SUPPORTED

A solicitação não terá suporte. Esse erro será retornado se nenhuma pilha IPv6 estiver localizada no computador local.
Outras

Use a função FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado.

Comentários

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

O cliente Teredo também usa a porta UDP estática 3544 para ouvir o tráfego de multicast que é enviado no endereço IPv4 de multicast 224.0.0.253, conforme definido na RFC 4380. Para obter mais informações, consulte Teredo: encapsulando IPv6 sobre UDPpor meio de NATs (Network Address Translations).

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

Requisitos

Plataforma de destino

 Universal

Versão

Disponível no Windows Vista e em versões posteriores dos sistemas operacionais Windows.

Cabeçalho

 Netioapi.h (incluir Netioapi.h)

Biblioteca

 Netio.lib

IRQL

< DISPATCH_LEVEL

Confira também

NotificarTeredoPortChange

NotifyStableUnicastIpAddressTable