Функция MprAdminInterfaceTransportAdd (mprapi.h)
Функция 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.
Если функция завершается сбоем, возвращается один из следующих кодов ошибок.
| Значение | Значение |
|---|---|
|
Вызывающее приложение не имеет достаточных привилегий. |
|
Недопустимое значение hInterface . |
|
Параметр pInterfaceInfo имеет значение NULL. |
|
Значение dwTransportId не соответствует ни одному поддерживаемому транспорту. |
Комментарии
Параметр dwTransportId также указывает диспетчер маршрутизатора, так как маршрутизатор использует разные диспетчеры маршрутизаторов для каждого транспорта.
Требования
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | mprapi.h |
| Библиотека | Mprapi.lib |
| DLL | Mprapi.dll |
См. также раздел
MprAdminInterfaceTransportRemove