Función GetTeredoPort (netioapi.h)

  • Artículo

La función GetTeredoPort recupera el número de puerto UDP dinámico usado por el cliente teredo en el equipo local.

Sintaxis

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetTeredoPort(
  [out] USHORT *Port
);

Parámetros

[out] Port

Puntero al número de puerto UDP. Si la devolución se realiza correctamente, este parámetro se rellenará con el número de puerto utilizado por el cliente teredo.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Código devuelto Descripción
ERROR_INVALID_PARAMETER
 Se pasó un parámetro no válido a la función. Este error se devuelve si se pasa un puntero NULL en el parámetro Port .
ERROR_NOT_READY
 El dispositivo no está listo. Este error se devuelve si el cliente teredo no se inicia en el equipo local.
ERROR_NOT_SUPPORTED
 No se admite la solicitud. Este error se devuelve si no hay ninguna pila IPv6 en el equipo local.
Otros
 Use FormatMessage para obtener la cadena de mensaje para el error devuelto.

Comentarios

La función GetTeredoPort se define en Windows Vista y versiones posteriores.

La función GetTeredoPort recupera el número de puerto UDP actual usado por el cliente Teredo para el puerto de servicio teredo. El puerto teredo es dinámico y puede cambiar en cualquier momento en que se reinicie el cliente teredo en el equipo local. Una aplicación puede registrarse para recibir una notificación cuando cambia el puerto del servicio Teredo llamando a la función NotifyTeredoPortChange .

El cliente teredo también usa el puerto UDP estático 3544 para escuchar el tráfico de multidifusión enviado en la dirección IPv4 de multidifusión 224.0.0.253 tal como se define en RFC 4380. Para obtener más información, vea http://www.ietf.org/rfc/rfc4380.txt.

Las aplicaciones de firewall usan principalmente la función GetTeredoPort para configurar las excepciones adecuadas para permitir el tráfico Teredo entrante y saliente.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado netioapi.h (include Iphlpapi.h)
Library Iphlpapi.lib
Archivo DLL Iphlpapi.dll

Consulte también

NotifyStableUnicastIpAddressTable

NotifyTeredoPortChange