Función GetTeredoPort
La función GetTeredoPort recupera el número de puerto UDP dinámico que usa el cliente Teredo en un equipo local.
Sintaxis
NETIOAPI_API GetTeredoPort(
_Out_ USHORT *Port
);
Parámetros
- Puerto [salida]
Puntero al número de puerto UDP. Si la devolución es correcta, este parámetro se rellena con el número de puerto que usa el cliente teredo.
Valor devuelto
GetTeredoPort devuelve STATUS_SUCCESS si la función se ejecuta correctamente.
Si se produce un error en la función, GetTeredoPort devuelve uno de los siguientes códigos de error:
| Código devuelto | Descripción |
|---|---|
| STATUS_INVALID_PARAMETER | Se ha transferido 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. |
| STATUS_NOT_SUPPORTED | No se admite la solicitud. Este error se devuelve si no hay ninguna pila IPv6 ubicada en el equipo local. |
| Otros | Use la función FormatMessage para obtener la cadena de mensaje para el error devuelto. |
Comentarios
La función GetTeredoPort recupera el número de puerto UDP actual que usa el cliente Teredo para el puerto del servicio Teredo. El puerto teredo es dinámico y puede cambiar cualquier vez que se reinicie el cliente teredo en el equipo local. Un controlador 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 que se envía 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 Teredo: Tunelización de IPv6 a través de traducciones de direcciones de red (NAT) de UDPthrough.
La función GetTeredoPort se usa principalmente por los controladores de firewall para configurar las excepciones adecuadas para habilitar el tráfico Teredo entrante y saliente.
Requisitos
Plataforma de destino |
Universal |
Versión |
Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
Encabezado |
Netioapi.h (incluye Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |