MprConfigInterfaceTransportAdd 函数 (mprapi.h)

项目
08/24/2023

MprConfigInterfaceTransportAdd 函数将传输协议添加到路由器上的接口配置。

语法

DWORD MprConfigInterfaceTransportAdd(
  [in]           HANDLE hMprConfig,
  [in]           HANDLE hRouterInterface,
  [in]           DWORD  dwTransportId,
  [in, optional] LPWSTR lpwsTransportName,
  [in]           LPBYTE pInterfaceInfo,
  [in]           DWORD  dwInterfaceInfoSize,
  [out]          HANDLE *phRouterIfTransport
);

parameters

[in] hMprConfig

路由器配置的句柄。通过调用 MprConfigServerConnect 获取此句柄。

[in] hRouterInterface

将指定传输添加到的接口配置的句柄。通过调用 MprConfigInterfaceCreate、 MprConfigInterfaceGetHandle 或 MprConfigInterfaceEnum 获取此句柄。

[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 字符串的指针，该字符串指定要添加的传输的名称。如果未指定此参数，并且传输为 IP 或 IPX， MprConfigInterfaceTransportAdd 将使用 IP 或 IPX。如果未指定此参数，并且传输不是 IP 或 IPX， 则 MprConfigInterfaceTransportAdd 会将 dwTransportId 参数转换为字符串，并将其用作传输名称。

[in] pInterfaceInfo

指向包含指定接口和传输的信息的信息标头的指针。指定传输的路由器管理器解释此信息。使用信息标头函数操作信息标头。

[in] dwInterfaceInfoSize

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

[out] phRouterIfTransport

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

返回值

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

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

值	含义
ERROR_INVALID_PARAMETER	下列情况之一存在： hMprConfig 为 NULL。 hRouterInterface 为 NULL。 phRouterIfTransport 为 NULL。
ERROR_NOT_ENOUGH_MEMORY	资源不足，无法完成操作。
其他	使用 FormatMessage 检索与返回的错误代码对应的系统错误消息。

注解

除了指定传输之外， dwTransportId 参数还指定路由器管理器，因为路由器为每个传输维护唯一的路由器管理器。

如果指定的传输已存在， MprConfigInterfaceTransportAdd 使用指定的参数值执行 MprConfigInterfaceTransportSetInfo 调用的等效项。

要求


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