Функция MprConfigTransportCreate (mprapi.h)
Функция MprConfigTransportCreate добавляет указанный транспорт в список транспортных протоколов, присутствующих в указанной конфигурации маршрутизатора.
Синтаксис
DWORD MprConfigTransportCreate(
[in] HANDLE hMprConfig,
[in] DWORD dwTransportId,
[in, optional] LPWSTR lpwsTransportName,
[in] LPBYTE pGlobalInfo,
[in] DWORD dwGlobalInfoSize,
[in, optional] LPBYTE pClientInterfaceInfo,
[in, optional] DWORD dwClientInterfaceInfoSize,
[in, optional] LPWSTR lpwsDLLPath,
[out] HANDLE *phRouterTransport
);
Параметры
[in] hMprConfig
Обработка конфигурации маршрутизатора, в которую добавляется транспорт. Получите этот дескриптор, вызвав MprConfigServerConnect.
[in] dwTransportId
Значение DWORD , описывающее транспорт, добавляемый в конфигурацию. Этот параметр также определяет диспетчер маршрутизатора для транспорта. Допустимые значения для dwTransportId перечислены в следующей таблице.
| Значение | Транспорт (семейство протоколов) |
|---|---|
| PID_ATALK | Appletalk |
| PID_IP | Интернет-протокол версии 4 |
| PID_IPX | Обмен пакетами через Интернет |
| PID_NBF | Протокол кадров NetBIOS |
| PID_IPV6 | Windows Server 2008 или более поздней версии: протокол Internet Protocol версии 6 |
[in, optional] lpwsTransportName
Указатель на строку Юникода, завершающуюся значением NULL, которая указывает имя добавляемого транспорта. Если этот параметр не указан, параметр dwTransportId преобразуется в строку и используется в качестве имени транспорта.
[in] pGlobalInfo
Указатель на заголовок сведений, указывающий глобальные сведения для транспорта. Диспетчер маршрутизатора для транспорта интерпретирует эти сведения. Используйте функции заголовков сведений для управления заголовками информации.
[in] dwGlobalInfoSize
Указывает размер (в байтах) данных, на которые указывает параметр pGlobalInfo .
[in, optional] pClientInterfaceInfo
Указатель на заголовок сведений, указывающий сведения об интерфейсе по умолчанию для клиентских маршрутизаторов. Эти сведения используются для настройки динамических интерфейсов для клиентских маршрутизаторов для этого транспорта. Используйте функции заголовков сведений для управления заголовками информации.
Этот параметр является необязательным; вызывающее приложение может указать значение NULL для этого параметра.
[in, optional] dwClientInterfaceInfoSize
Задает размер (в байтах) данных, на которые указывает параметр pClientInterfaceInfo . Если вызывающее приложение задает значение NULL для pClientInterfaceInfo, вызывающее приложение должно указать ноль для этого параметра.
[in, optional] lpwsDLLPath
Указатель на строку Юникода, завершающуюся null, которая указывает имя библиотеки DLL диспетчера маршрутизатора для указанного транспорта. Если указано это имя, функция задает путь DLL для этого транспорта в соответствии с этим именем.
Этот параметр является необязательным; вызывающее приложение может указать значение NULL для этого параметра.
[out] phRouterTransport
Указатель на
Переменная HANDLE, получающая тип дескриптора конфигурации транспорта, указанный в параметре dwTransportId.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет NO_ERROR.
Если функция завершается сбоем, возвращается один из следующих кодов ошибок.
| Значение | Значение |
|---|---|
|
Параметр hMprConfig имеет значение NULL, параметр phRouterTransport имеет значение NULL или оба параметра имеют значение NULL. |
|
Недостаточно ресурсов для завершения операции. |
|
Используйте FormatMessage , чтобы получить системное сообщение об ошибке, соответствующее возвращаемому коду ошибки. |
Комментарии
Если указанный транспорт уже существует, MprConfigTransportCreate выполняет эквивалент вызова MprConfigTransportSetInfo , используя предоставленные значения параметров.
Требования
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | mprapi.h |
| Библиотека | Mprapi.lib |
| DLL | Mprapi.dll |