通过

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
);

parameters

[in] hMprConfig

要向其添加传输的路由器配置的句柄。 通过调用 MprConfigServerConnect 获取此句柄。

[in] dwTransportId

描述要添加到配置的传输的 DWORD 值。 此参数还标识传输的路由器管理器。 下表列出了 dwTransportId 的可接受值。

值 传输 (协议系列)
PID_ATALK AppleTalk
PID_IP Internet 协议版本 4
PID_IPX Internet 数据包交换
PID_NBF NetBIOS 帧协议
PID_IPV6 Windows Server 2008 或更高版本：Internet 协议版本 6

[in, optional] lpwsTransportName

指向 以 null 结尾的 Unicode 字符串的指针，该字符串指定要添加的传输的名称。 如果未指定此参数， dwTransportId 参数将转换为字符串并用作传输名称。

[in] pGlobalInfo

指向指定传输全局信息的信息标头的指针。 传输的路由器管理器解释此信息。 使用 信息标头函数 操作信息标头。

[in] dwGlobalInfoSize

指定 pGlobalInfo 参数指向的数据的大小（以字节为单位）。

[in, optional] pClientInterfaceInfo

指向指定客户端路由器的默认接口信息的信息标头的指针。 此信息用于为此传输配置客户端路由器的动态接口。 使用 信息标头函数 操作信息标头。

此参数是可选的;调用应用程序可以为此参数指定 NULL 。

[in, optional] dwClientInterfaceInfoSize

指定 pClientInterfaceInfo 参数指向的数据的大小（以字节为单位）。 如果调用应用程序为 pClientInterfaceInfo 指定 NULL，则调用应用程序应为此参数指定零。

[in, optional] lpwsDLLPath

指向 以 null 结尾的 Unicode 字符串的指针，该字符串指定指定传输的路由器管理器 DLL 的名称。 如果指定了此名称，则函数会将此传输的 DLL 路径设置为此名称。

此参数是可选的;调用应用程序可以为此参数指定 NULL 。

[out] phRouterTransport

指向
HANDLE 变量，用于接收 dwTransportId 参数中指示的传输配置句柄类型。

返回值

如果函数成功，则返回值NO_ERROR。

如果函数失败，则返回值为以下错误代码之一。

值 含义
ERROR_INVALID_PARAMETER
 hMprConfig 参数为 NULL，或 phRouterTransport 参数为 NULL，或两者均为 NULL。
ERROR_NOT_ENOUGH_MEMORY
 资源不足，无法完成操作。
其他
 使用 FormatMessage 检索与返回的错误代码对应的系统错误消息。

注解

如果指定的传输已存在， MprConfigTransportCreate 使用提供的参数值执行 与 MprConfigTransportSetInfo 调用等效的操作。

要求

   
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 mprapi.h
Library Mprapi.lib
DLL Mprapi.dll

另请参阅

FormatMessage

MprConfigServerConnect

路由器配置函数

路由器管理参考