Função GetTeredoPort (netioapi.h)
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 |
|---|---|
|
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 . |
|
O dispositivo não está pronto. Esse erro será retornado se o cliente Teredo não for iniciado no computador local. |
|
A solicitação não terá suporte. Esse erro será retornado se nenhuma pilha IPv6 estiver no computador local. |
|
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 |