Partilhar via


Função GetTeredoPort

O função GetTeredoPort recupera o número de porta UDP dinâmico que o cliente Teredo usa em um computador local.

Sintaxe

NETIOAPI_API GetTeredoPort(
  _Out_ USHORT *Port
);

Parâmetros

  • Porto [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 de retorno

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

Se a função falhar, GetTeredoPort retornará 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. Este erro é retornado se um ponteiro de NULL é passado no parâmetro Port.

ERROR_NOT_READY

O dispositivo não está pronto. Este erro é retornado se o cliente Teredo não for iniciado no computador local.

STATUS_NOT_SUPPORTED

A solicitação não é suportada. Este erro é retornado se nenhuma pilha IPv6 estiver localizada no computador local.

Outros

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

Comentários

O 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 de serviço Teredo for alterada chamando a funçãoNotifyTeredoPortChange.

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 multicast 224.0.0.253, conforme definido na RFC 4380. Para obter mais informações, consulte Teredo: Tunneling IPv6 over UDPthrough Network Address Translations (NATs).

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.

Requerimentos

Plataforma de destino

Universal

Versão

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

Cabeçalho

Netioapi.h (inclui Netioapi.h)

Biblioteca

Netio.lib

IRQL

< DISPATCH_LEVEL

Ver também

NotifyTeredoPortChange

NotifyStableUnicastIpAddressTable