Функция GetTeredoPort
Функция GetTeredoPort извлекает динамический номер порта UDP, используемый клиентом Teredo на локальном компьютере.
Синтаксис
NETIOAPI_API GetTeredoPort(
_Out_ USHORT *Port
);
Параметры
-
порт [out]
Указатель на номер порта UDP. При успешном возвращении этот параметр заполняется номером порта, используемым клиентом Teredo.
Возвращаемое значение
GetTeredoPort возвращает STATUS_SUCCESS, если функция выполнена успешно.
Если функция завершается ошибкой, GetTeredoPort возвращает один из следующих кодов ошибок:
| Возвращаемый код | Описание |
|---|---|
| STATUS_INVALID_PARAMETER | Недопустимый параметр был передан функции. Эта ошибка возвращается, если указатель NULL передается в параметре порта. |
| ERROR_NOT_READY | Устройство не готово. Эта ошибка возвращается, если клиент Teredo не запущен на локальном компьютере. |
| STATUS_NOT_SUPPORTED | Запрос не поддерживается. Эта ошибка возвращается, если на локальном компьютере отсутствует стек IPv6. |
| Другие | Используйте функцию FormatMessage, чтобы получить строку сообщения для возвращаемой ошибки. |
Замечания
Функция GetTeredoPort извлекает текущий номер порта UDP, используемый клиентом Teredo для порта службы Teredo. Порт Teredo является динамическим и может изменяться в любое время перезапуска клиента Teredo на локальном компьютере. Драйвер может регистрироваться, когда порт службы Teredo изменяется, вызвав функцию NotifyTeredoPortChange.
Клиент Teredo также использует статический порт UDP 3544 для прослушивания многоадресного трафика, который отправляется по адресу IPv4 многоадресной рассылки 224.0.0.253, как определено в RFC 4380. Дополнительные сведения см. в Teredo: туннелирование IPv6 попреобразования сетевых адресов (NATs) UDPthrough.
Функция GetTeredoPort используется в основном драйверами брандмауэра для настройки соответствующих исключений для включения входящего и исходящего трафика Teredo.