Funzione GetTeredoPort
La funzione GetTeredoPort recupera il numero di porta UDP dinamico utilizzato dal client Teredo in un computer locale.
Sintassi
NETIOAPI_API GetTeredoPort(
_Out_ USHORT *Port
);
Parametri
- Porta [out]
Puntatore al numero di porta UDP. In caso di esito positivo, questo parametro viene compilato con il numero di porta usato dal client Teredo.
Valore restituito
GetTeredoPort restituisce STATUS_SUCCESS se la funzione ha esito positivo.
Se la funzione ha esito negativo, GetTeredoPort restituisce uno dei codici di errore seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_PARAMETER | Alla funzione è stato passato un parametro non valido. Questo errore viene restituito se viene passato un puntatore NULL nel parametro Port . |
| ERROR_NOT_READY | Il dispositivo non è pronto. Questo errore viene restituito se il client Teredo non viene avviato nel computer locale. |
| STATUS_NOT_SUPPORTED | La richiesta non è supportata. Questo errore viene restituito se non si trova alcun stack IPv6 nel computer locale. |
| Altro | Utilizzare la funzione FormatMessage per ottenere la stringa del messaggio per l'errore restituito. |
Osservazioni:
La funzione GetTeredoPort recupera il numero di porta UDP corrente usato 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 driver 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 Teredo: Tunneling IPv6 over UDPthrough Network Address Translations (NAT).
La funzione GetTeredoPort viene usata principalmente dai driver del firewall per configurare le eccezioni appropriate per abilitare il traffico Teredo in ingresso e in uscita.
Requisiti
Piattaforma di destinazione |
Universale |
Versione |
Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
Intestazione |
Netioapi.h (include Netioapi.h) |
Libreria |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |