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。
如果函数失败，则返回值为以下错误代码之一。
| 值 | 含义 |
|---|---|
|
hMprConfig 参数为 NULL，或 phRouterTransport 参数为 NULL，或两者均为 NULL。 |
|
资源不足，无法完成操作。 |
|
使用 FormatMessage 检索与返回的错误代码对应的系统错误消息。 |
注解
如果指定的传输已存在， MprConfigTransportCreate 使用提供的参数值执行 与 MprConfigTransportSetInfo 调用等效的操作。
要求
| 最低受支持的客户端 | 无受支持的版本 |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | mprapi.h |
| Library | Mprapi.lib |
| DLL | Mprapi.dll |