Função GetTeredoPort
A 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
-
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 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. Esse erro será retornado se um ponteiro NULL for passado no parâmetro porta. |
| 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 | Não há suporte para a solicitação. Esse erro será 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. |
Observações
A função GetTeredoPort recupera o número da porta UDP atual que o cliente Teredo usa para a porta de serviço do Teredo. A porta Teredo é dinâmica e pode alterar sempre que o cliente Teredo é reiniciado no computador local. Um driver pode se registrar para ser notificado quando a porta de serviço do Teredo for alterada chamando a funçãoNotifyTeredoPortChange.
O cliente Teredo também usa a porta UDP estática 3544 para escutar o tráfego multicast que é enviado no endereço IPv4 multicast 224.0.0.253, conforme definido no 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.
Requisitos
Plataforma de destino |
Universal |
Versão |
Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
Cabeçalho |
Netioapi.h (inclua Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |