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

Статья
03/15/2023

Функция MprAdminInterfaceTransportAdd добавляет транспорт (например, IP или IPX) в указанный интерфейс.

Синтаксис

DWORD MprAdminInterfaceTransportAdd(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwTransportId,
  [in] LPBYTE            pInterfaceInfo,
  [in] DWORD             dwInterfaceInfoSize
);

Параметры

[in] hMprServer

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

[in] hInterface

Дескриптор интерфейса, в котором добавляется транспорт. Этот дескриптор получен при предыдущем вызове MprAdminInterfaceCreate.

[in] dwTransportId

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

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

[in] pInterfaceInfo

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

[in] dwInterfaceInfoSize

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

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

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

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

Значение	Значение
ERROR_ACCESS_DENIED	Вызывающее приложение не имеет достаточных привилегий.
ERROR_INVALID_HANDLE	Недопустимое значение hInterface .
ERROR_INVALID_PARAMETER	Параметр pInterfaceInfo имеет значение NULL.
ERROR_UNKNOWN_PROTOCOL_ID	Значение dwTransportId не соответствует ни одному поддерживаемому транспорту.

Требования


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