MprAdminTransportCreate 函数 (mprapi.h)

  • 项目

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 Internet 协议版本 4
PID_IPX Internet 数据包交换
PID_NBF NetBIOS 帧协议
PID_IPV6 Windows Server 2008 或更高版本：Internet 协议版本 6

[in, optional] lpwsTransportName

指向以 null 结尾的 Unicode 字符串的指针，该字符串指定传输的名称。

[in] pGlobalInfo

指向指定传输全局信息的缓冲区的指针。 使用 信息标头函数 可操作信息标头。

[in] dwGlobalInfoSize

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

[in, optional] pClientInterfaceInfo

指向指定传输的默认客户端接口信息的缓冲区的指针。

此参数是可选的。 如果调用应用程序为此参数指定 NULL ，则该函数不会设置默认客户端接口信息。

[in, optional] dwClientInterfaceInfoSize

指定 pClientInterfaceInfo 参数指向的缓冲区的大小（以字节为单位）。

[in] lpwsDLLPath

指向以 null 结尾的 Unicode 字符串的指针，该字符串指定传输的 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
标头 mprapi.h
Library Mprapi.lib
DLL Mprapi.dll

另请参阅

MprAdminTransportGetInfo

MprAdminTransportSetInfo