Share via

Функция GetTeredoPort (netioapi.h)

  • Статья

Функция GetTeredoPort извлекает динамический номер порта UDP, используемый клиентом Teredo на локальном компьютере.

Синтаксис

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetTeredoPort(
  [out] USHORT *Port
);

Параметры

[out] Port

Указатель на номер порта UDP. При успешном возвращении этот параметр будет заполнен номером порта, используемым клиентом Teredo.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет NO_ERROR.

Если функция завершается сбоем, возвращаемое значение представляет собой один из следующих кодов ошибок.

Код возврата Описание
ERROR_INVALID_PARAMETER
 В функцию передан недопустимый параметр. Эта ошибка возвращается, если в параметре Port передается указатель NULL.
ERROR_NOT_READY
 Устройство не готово. Эта ошибка возвращается, если клиент Teredo не запущен на локальном компьютере.
ERROR_NOT_SUPPORTED
 Запрос не поддерживается. Эта ошибка возвращается, если на локальном компьютере нет стека IPv6.
Другое
 Используйте FormatMessage , чтобы получить строку сообщения для возвращенной ошибки.

Комментарии

Функция GetTeredoPort определена в Windows Vista и более поздних версиях.

Функция GetTeredoPort извлекает текущий номер порта UDP, используемый клиентом Teredo для порта службы Teredo. Порт Teredo является динамическим и может измениться при перезапуске клиента Teredo на локальном компьютере. Приложение можно зарегистрировать для получения уведомлений о смене порта службы Teredo, вызвав функцию NotifyTeredoPortChange .

Клиент Teredo также использует статический UDP-порт 3544 для прослушивания многоадресного трафика, отправленного по многоадресной IPv4-адресу 224.0.0.253, как определено в RFC 4380. Для получения дополнительной информации см. http://www.ietf.org/rfc/rfc4380.txt.

Функция GetTeredoPort используется в основном приложениями брандмауэра для настройки соответствующих исключений для разрешения входящего и исходящего трафика Teredo.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header netioapi.h (включая Iphlpapi.h)
Библиотека Iphlpapi.lib
DLL Iphlpapi.dll

См. также раздел

NotifyStableUnicastIpAddressTable

NotifyTeredoPortChange