Partager via

GetTeredoPort, fonction (netioapi.h)

  • Article

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
ERROR_INVALID_PARAMETER
 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 .
ERROR_NOT_READY
 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.
ERROR_NOT_SUPPORTED
 La demande n'est pas prise en charge. Cette erreur est retournée si aucune pile IPv6 n’est sur l’ordinateur local.
Autres
 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

Voir aussi

NotifyStableUnicastIpAddressTable

NotifyTeredoPortChange