Функция GetTeredoPort
Функция GetTeredoPort извлекает динамический номер порта UDP, используемый клиентом Teredo на локальном компьютере.
Синтаксис
NETIOAPI_API GetTeredoPort(
_Out_ USHORT *Port
);
Параметры
- Порт [out]
Указатель на номер порта UDP. При успешном возвращении этот параметр заполняется номером порта, используемым клиентом Teredo.
Возвращаемое значение
GetTeredoPort возвращает STATUS_SUCCESS, если функция выполнена успешно.
Если функция завершается ошибкой, GetTeredoPort возвращает один из следующих кодов ошибок:
| Код возврата | Description |
|---|---|
| STATUS_INVALID_PARAMETER | Недопустимый параметр был передан функции. Эта ошибка возвращается, если указатель NULL передается в параметре Port . |
| 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.
Требования
Целевая платформа |
Универсальный |
Версия |
Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
Верхний колонтитул |
Netioapi.h (include Netioapi.h) |
Библиотека |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |