GetTeredoPort, fonction (netioapi.h)
La fonction GetTeredoPort récupère le numéro de port UDP dynamique utilisé par le client Teredo sur l’ordinateur local.
Syntaxe
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetTeredoPort(
[out] USHORT *Port
);
Paramètres
[out] Port
Pointeur vers le numéro de port UDP. Une fois le retour réussi, ce paramètre est rempli avec le numéro de port utilisé par le client Teredo.
Valeur retournée
Si la fonction réussit, la valeur de retour est NO_ERROR.
Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.
| Code de retour | Description |
|---|---|
|
Un paramètre non valide a été transmis à la fonction. Cette erreur est retournée si un pointeur NULL est passé dans le paramètre Port . |
|
Le périphérique n’est pas prêt. Cette erreur est retournée si le client Teredo n’est pas démarré sur l’ordinateur local. |
|
La demande n'est pas prise en charge. Cette erreur est retournée si aucune pile IPv6 n’est sur l’ordinateur local. |
|
Utilisez FormatMessage pour obtenir la chaîne de message de l’erreur retournée. |
Remarques
La fonction GetTeredoPort est définie sur Windows Vista et versions ultérieures.
La fonction GetTeredoPort récupère le numéro de port UDP actuel utilisé par le client Teredo pour le port de service Teredo. Le port Teredo est dynamique et peut changer à tout redémarrage du client Teredo sur l’ordinateur local. Une application peut s’inscrire pour être avertie lorsque le port du service Teredo change en appelant la fonction NotifyTeredoPortChange .
Le client Teredo utilise également le port UDP statique 3544 pour écouter le trafic de multidiffusion envoyé sur l’adresse IPv4 de multidiffusion 224.0.0.253 telle que définie dans RFC 4380. Pour plus d’informations, consultez http://www.ietf.org/rfc/rfc4380.txt.
La fonction GetTeredoPort est principalement utilisée par les applications de pare-feu afin de configurer les exceptions appropriées afin d’autoriser le trafic Teredo entrant et sortant.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | netioapi.h (include Iphlpapi.h) |
| Bibliothèque | Iphlpapi.lib |
| DLL | Iphlpapi.dll |