Função GetTeredoPort
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 |