MprAdminInterfaceTransportAdd 函数 (mprapi.h)

  • 项目

MprAdminInterfaceTransportAdd 函数将传输 (例如 IP 或 IPX) 添加到指定的接口。

语法

DWORD MprAdminInterfaceTransportAdd(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwTransportId,
  [in] LPBYTE            pInterfaceInfo,
  [in] DWORD             dwInterfaceInfoSize
);

parameters

[in] hMprServer

要添加信息的路由器的句柄。 通过调用 MprAdminServerConnect 获取此句柄。

[in] hInterface

要添加传输的接口的句柄。 此句柄是通过上一次调用 MprAdminInterfaceCreate 获取的。

[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] pInterfaceInfo

指向指定此传输的接口信息的信息标头的指针。 使用 信息标头函数 操作信息标头。

[in] dwInterfaceInfoSize

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

返回值

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

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

值 含义
ERROR_ACCESS_DENIED
 调用应用程序没有足够的权限。
ERROR_INVALID_HANDLE
 hInterface 值无效。
ERROR_INVALID_PARAMETER
 pInterfaceInfo 参数为 NULL。
ERROR_UNKNOWN_PROTOCOL_ID
 dwTransportId 值与任何受支持的传输不匹配。

注解

dwTransportId 参数还指定路由器管理器，因为路由器对每次传输使用不同的路由器管理器。

要求

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

另请参阅

MprAdminInterfaceCreate

MprAdminInterfaceTransportRemove

MprAdminServerConnect

路由器管理功能

路由器管理参考