通过

PADD_INTERFACE回调函数 (routprot.h)

  • 项目

AddInterface 函数添加要由路由协议管理的接口。 协议应将接口视为处于禁用状态。 路由器管理器通过使用 RIS_INTERFACE_ENABLED 标志调用 InterfaceStatus 来启用接口。

当用户调用 MprAdminInterfaceTransportAdd 时，传输的动态接口管理器将调用路由器管理器 (传输) 传输) 该传输协议针对与该传输关联的每个路由协议调用此函数。

语法

PADD_INTERFACE PaddInterface;

DWORD PaddInterface(
  [in] LPWSTR InterfaceName,
  [in] ULONG InterfaceIndex,
  [in] NET_INTERFACE_TYPE InterfaceType,
  [in] DWORD MediaType,
  [in] WORD AccessType,
  [in] WORD ConnectionType,
  [in] PVOID InterfaceInfo,
  [in] ULONG StructureVersion,
  [in] ULONG StructureSize,
  [in] ULONG StructureCount
)
{...}

参数

[in] InterfaceName

指向 Unicode 字符串的指针。 字符串包含一个名称，该名称唯一标识路由器上配置的接口集中的接口。

[in] InterfaceIndex

指定路由器上配置的接口集中的接口。

[in] InterfaceType

指定接口的类型。

值 含义
永久
 永久连接 (例如 LAN、帧中继) 。
DEMAND_DIAL
 要求拨号连接 (模拟、ISDN、PPTP、切换 FR) 。
LOCAL_WORKSTATION_DIAL
 仅本地工作站连接。
REMOTE_WORKSTATION_DIAL
 仅远程工作站连接。

[in] MediaType

留待将来使用。

[in] AccessType

留待将来使用。

[in] ConnectionType

留待将来使用。

[in] InterfaceInfo

指向缓冲区的指针，该缓冲区指定与接口关联的协议定义的配置信息。 此信息是路由协议的专用信息。

[in] StructureVersion

指定 InterfaceInfo 参数指向的信息结构的版本。 在某些情况下，这等于路由协议的版本。

[in] StructureSize

指定 InterfaceInfo 参数指向的每个信息结构的大小。 由于某些信息结构包含可变长度成员，路由协议不一定能够确定版本信息的大小。

[in] StructureCount

指定 InterfaceInfo 参数指向的信息结构的数量计数。 此参数始终为 1。

返回值

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

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

值 说明
ERROR_CAN_NOT_COMPLETE
 尝试添加接口失败。
ERROR_INVALID_PARAMETER
 InterfaceIndex 参数无效 (例如，具有该索引的接口已存在) ，或者 InterfaceInfo 指向的某个参数无效。
 
 

要求

要求 值
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 routprot.h

另请参阅

DeleteInterface

路由协议接口函数

路由协议接口参考