Condividi tramite

Funzione GetTeredoPort (netioapi.h)

  • Articolo

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
ERROR_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.
ERROR_NOT_SUPPORTED
 La richiesta non è supportata. Questo errore viene restituito se non si trova alcun stack IPv6 nel computer locale.
Altri
 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

Vedi anche

NotifyStableUnicastIpAddressTable

NotifyTeredoPortChange