Функция MprConfigInterfaceTransportAdd (mprapi.h)

Статья
08/24/2023

Функция MprConfigInterfaceTransportAdd добавляет транспортный протокол в конфигурацию интерфейса на маршрутизаторе.

Синтаксис

DWORD MprConfigInterfaceTransportAdd(
  [in]           HANDLE hMprConfig,
  [in]           HANDLE hRouterInterface,
  [in]           DWORD  dwTransportId,
  [in, optional] LPWSTR lpwsTransportName,
  [in]           LPBYTE pInterfaceInfo,
  [in]           DWORD  dwInterfaceInfoSize,
  [out]          HANDLE *phRouterIfTransport
);

Параметры

[in] hMprConfig

Дескриптор конфигурации маршрутизатора. Получите этот дескриптор, вызвав mprConfigServerConnect.

[in] hRouterInterface

Дескриптор конфигурации интерфейса, в которую добавляется указанный транспорт. Получите этот дескриптор, вызвав MprConfigInterfaceCreate, MprConfigInterfaceGetHandle или MprConfigInterfaceEnum.

[in] dwTransportId

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

Значение	Транспорт (семейство протоколов)
PID_ATALK	Appletalk
PID_IP	Протокол ИНТЕРНЕТА версии 4
PID_IPX	Обмен пакетами в Интернете
PID_NBF	Протокол netBIOS-кадров
PID_IPV6	Windows Server 2008 или более поздней версии: протокол INTERNET версии 6

[in, optional] lpwsTransportName

Указатель на строку Юникода, завершающуюся null, которая указывает имя добавляемого транспорта. Если этот параметр не указан и транспортом является IP или IPX, MprConfigInterfaceTransportAdd использует IP или IPX. Если этот параметр не указан и транспорт отличается от IP или IPX, MprConfigInterfaceTransportAdd преобразует параметр dwTransportId в строку и использует его в качестве имени транспорта.

[in] pInterfaceInfo

Указатель на заголовок сведений, содержащий сведения для указанного интерфейса и транспорта. Диспетчер маршрутизатора для указанного транспорта интерпретирует эти сведения. Используйте функции заголовков сведений для управления заголовками информации.

[in] dwInterfaceInfoSize

Указывает размер (в байтах) данных, на которые указывает pInterfaceInfo.

[out] phRouterIfTransport

Указатель на
Переменная HANDLE, которая получает тип дескриптора конфигурации транспорта для этого интерфейса, указанного в параметре dwTransportId.

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

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

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

Значение	Значение
ERROR_INVALID_PARAMETER	Выполняется одно из следующих условий. hMprConfig имеет значение NULL. hRouterInterface имеет значение NULL. phRouterIfTransport имеет значение NULL.
ERROR_NOT_ENOUGH_MEMORY	Недостаточно ресурсов для завершения операции.
Другое	Используйте FormatMessage , чтобы получить системное сообщение об ошибке, соответствующее возвращаемому коду ошибки.

Помимо указания транспорта, параметр dwTransportId также указывает диспетчер маршрутизатора, так как маршрутизатор поддерживает уникальный диспетчер маршрутизатора для каждого транспорта.

Если указанный транспорт уже существует, MprConfigInterfaceTransportAdd выполняет эквивалент вызова MprConfigInterfaceTransportSetInfo , используя указанные значения параметров.

Требования


Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	mprapi.h
Библиотека	Mprapi.lib
DLL	Mprapi.dll