GetTeredoPort, fonction
La fonction GetTeredoPort récupère le numéro de port UDP dynamique utilisé par le client Teredo sur un ordinateur local.
Syntaxe
NETIOAPI_API GetTeredoPort(
_Out_ USHORT *Port
);
Paramètres
- Port [out]
Pointeur vers le numéro de port UDP. Lors d’un retour réussi, ce paramètre est rempli avec le numéro de port utilisé par le client Teredo.
Valeur retournée
GetTeredoPort retourne STATUS_SUCCESS si la fonction réussit.
Si la fonction échoue, GetTeredoPort retourne l’un des codes d’erreur suivants :
| Code de retour | Description |
|---|---|
| STATUS_INVALID_PARAMETER | Un paramètre non valide a été passé à 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. |
| STATUS_NOT_SUPPORTED | La demande n'est pas prise en charge. Cette erreur est retournée si aucune pile IPv6 n’est située sur l’ordinateur local. |
| Autres | Utilisez la fonction FormatMessage pour obtenir la chaîne de message correspondant à l’erreur renvoyée. |
Notes
La fonction GetTeredoPort récupère le numéro de port UDP actuel utilisé par le client Teredo pour le port du service Teredo. Le port Teredo est dynamique et peut changer chaque fois que le client Teredo est redémarré sur l’ordinateur local. Un pilote peut s’inscrire pour être averti 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 multidiffusion 224.0.0.253 tel que défini dans RFC 4380. Pour plus d’informations, consultez Teredo : Tunneling IPv6 over UDPthrough Network Address Translation (NATs).
La fonction GetTeredoPort est utilisée principalement par les pilotes de pare-feu afin de configurer les exceptions appropriées pour activer le trafic Teredo entrant et sortant.
Spécifications
Plateforme cible |
Universal |
Version |
Disponible sous Windows Vista et les versions ultérieures du système d’exploitation Windows. |
En-tête |
Netioapi.h (inclure Netioapi.h) |
Bibliothèque |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |