Funzione GetTeredoPort (netioapi.h)
La funzione GetTeredoPort recupera il numero di porta UDP dinamico utilizzato dal client Teredo nel computer locale.
Sintassi
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetTeredoPort(
[out] USHORT *Port
);
Parametri
[out] Port
Puntatore al numero di porta UDP. In caso di esito positivo, questo parametro verrà compilato con il numero di porta usato dal client Teredo.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.
Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Alla funzione è stato passato un parametro non valido. Questo errore viene restituito se viene passato un puntatore NULL nel parametro Port . |
|
Il dispositivo non è pronto. Questo errore viene restituito se il client Teredo non viene avviato nel computer locale. |
|
La richiesta non è supportata. Questo errore viene restituito se non si trova alcun stack IPv6 nel computer locale. |
|
Usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito. |
Commenti
La funzione GetTeredoPort è definita in Windows Vista e versioni successive.
La funzione GetTeredoPort recupera il numero di porta UDP corrente utilizzato dal client Teredo per la porta del servizio Teredo. La porta Teredo è dinamica e può cambiare ogni volta che il client Teredo viene riavviato nel computer locale. Un'applicazione può registrarsi per ricevere una notifica quando la porta del servizio Teredo cambia chiamando la funzione NotifyTeredoPortChange.
Il client Teredo usa anche la porta UDP statica 3544 per l'ascolto del traffico multicast inviato sull'indirizzo IPv4 multicast 224.0.0.253, come definito in RFC 4380. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc4380.txt.
La funzione GetTeredoPort viene usata principalmente dalle applicazioni firewall per configurare le eccezioni appropriate per consentire il traffico Teredo in ingresso e in uscita.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | netioapi.h (include Iphlpapi.h) |
| Libreria | Iphlpapi.lib |
| DLL | Iphlpapi.dll |