Поделиться через

функция обратного вызова PADD_INTERFACE (routprot.h)

  • Статья

Функция AddInterface добавляет интерфейс для управления с помощью протокола маршрутизации. Протокол должен считать интерфейс отключенным. Диспетчер маршрутизатора включает интерфейс, вызывая InterfaceStatus с флагом RIS_INTERFACE_ENABLED.

Когда пользователь вызывает MprAdminInterfaceTransportAdd, диспетчер динамических интерфейсов для транспорта вызывает диспетчер маршрутизатора (для транспорта), который вызывает эту функцию для каждого из протоколов маршрутизации, связанных с этим транспортом.

Синтаксис

PADD_INTERFACE PaddInterface;

DWORD PaddInterface(
  [in] LPWSTR InterfaceName,
  [in] ULONG InterfaceIndex,
  [in] NET_INTERFACE_TYPE InterfaceType,
  [in] DWORD MediaType,
  [in] WORD AccessType,
  [in] WORD ConnectionType,
  [in] PVOID InterfaceInfo,
  [in] ULONG StructureVersion,
  [in] ULONG StructureSize,
  [in] ULONG StructureCount
)
{...}

Параметры

[in] InterfaceName

Указатель на строку Юникода. Строка содержит имя, которое однозначно идентифицирует интерфейс в наборе интерфейсов, настроенных на маршрутизаторе.

[in] InterfaceIndex

Указывает интерфейс в наборе интерфейсов, настроенных на маршрутизаторе.

[in] InterfaceType

Указывает тип интерфейса.

Значение Значение
ПОСТОЯННОГО
 Постоянное подключение (например, локальная сеть, ретранслятор кадров).
DEMAND_DIAL
 Подключение по запросу (аналоговое подключение, ISDN, PPTP, коммутируемая FR).
LOCAL_WORKSTATION_DIAL
 Только подключение к локальной рабочей станции.
REMOTE_WORKSTATION_DIAL
 Только подключение к удаленной рабочей станции.

[in] MediaType

Зарезервировано для будущего использования.

[in] AccessType

Зарезервировано для будущего использования.

[in] ConnectionType

Зарезервировано для будущего использования.

[in] InterfaceInfo

Указатель на буфер, указывающий определяемые протоколом сведения о конфигурации, связанные с интерфейсом. Эти сведения являются частными для протокола маршрутизации.

[in] StructureVersion

Указывает версию информационных структур, на которые указывает параметр InterfaceInfo . В некоторых случаях это значение равно версии протокола маршрутизации.

[in] StructureSize

Задает размер каждой информационной структуры, на которую указывает параметр InterfaceInfo . Так как некоторые информационные структуры содержат элементы переменной длины, протокол маршрутизации не обязательно может определить размер сведений из версии.

[in] StructureCount

Указывает количество информационных структур, на которые указывает параметр InterfaceInfo . Этот параметр всегда является одним.

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

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

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

Значение Описание
ERROR_CAN_NOT_COMPLETE
 Не удалось добавить интерфейс.
ERROR_INVALID_PARAMETER
 Недопустимый параметр InterfaceIndex (например, интерфейс с этим индексом уже существует) или один из параметров, на который указывает InterfaceInfo , является недопустимым.
 
 

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header routprot.h

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

DeleteInterface

Функции интерфейса протокола маршрутизации

Справочник по интерфейсу протокола маршрутизации