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

Статья
08/24/2023

Функция MprAdminTransportCreate загружает новый транспорт и запускает диспетчер маршрутизатора для транспорта.

Синтаксис

DWORD MprAdminTransportCreate(
  [in]           MPR_SERVER_HANDLE hMprServer,
  [in]           DWORD             dwTransportId,
  [in, optional] LPWSTR            lpwsTransportName,
  [in]           LPBYTE            pGlobalInfo,
  [in]           DWORD             dwGlobalInfoSize,
  [in, optional] LPBYTE            pClientInterfaceInfo,
  [in, optional] DWORD             dwClientInterfaceInfoSize,
  [in]           LPWSTR            lpwsDLLPath
);

Параметры

[in] hMprServer

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

[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

Указатель на строку Юникода с пустым завершением, указывающую имя транспорта.

[in] pGlobalInfo

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

[in] dwGlobalInfoSize

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

[in, optional] pClientInterfaceInfo

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

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

[in, optional] dwClientInterfaceInfoSize

Задает размер (в байтах) буфера, на который указывает параметр pClientInterfaceInfo .

[in] lpwsDLLPath

Указатель на строку Юникода, завершающуюся значением NULL, которая указывает путь к библиотеке DLL для транспорта.

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

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

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

Значение	Значение
ERROR_ACCESS_DENIED	Вызывающее приложение не имеет достаточных привилегий.
ERROR_INVALID_PARAMETER	Параметр pGlobalInfo и параметр pClientInterfaceInfo имеют значение NULL.
ERROR_NOT_ENOUGH_MEMORY	Недостаточно ресурсов для завершения операции.
ERROR_PROTOCOL_ALREADY_INSTALLED	Указанный транспорт уже запущен на указанном маршрутизаторе.
ERROR_UNKNOWN_PROTOCOL_ID	Значение dwTransportId не соответствует ни одному поддерживаемому транспортному протоколу.

Требования

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

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

MprAdminTransportGetInfo

MprAdminTransportSetInfo

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