PGET_INTERFACE_INFO回调函数 (routprot.h)

GetInterfaceInfo 函数获取特定接口的路由协议保留的配置信息。

语法

PGET_INTERFACE_INFO PgetInterfaceInfo;

DWORD PgetInterfaceInfo(
  [in]      ULONG InterfaceIndex,
  [in]      PVOID InterfaceInfo,
  [in, out] PULONG BufferSize,
  [in]      PULONG StructureVersion,
  [in]      PULONG StructureSize,
  [in]      PULONG StructureCount
)
{...}

参数

[in] InterfaceIndex

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

[in] InterfaceInfo

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

[in, out] BufferSize

指向 DWORD 变量的指针。

输入时:此变量指定为接收配置信息而提供的缓冲区的大小(以字节为单位)。

输出时:此变量接收放置在缓冲区中的数据的大小(以字节为单位)。 如果初始大小不够大,则此变量包含保存所有数据所需的大小。

[in] StructureVersion

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

[in] StructureSize

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

[in] StructureCount

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

返回值

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

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

说明
ERROR_CAN_NOT_COMPLETE
尝试检索信息失败。
ERROR_INVALID_PARAMETER
InterfaceIndex 参数无效 (例如,不存在具有该索引) 的接口,或者 InterfaceInfoSize 参数为 NULL
ERROR_INSUFFICIENT_BUFFER
提供的输出缓冲区的大小不足以保存请求的信息。 所需大小在 InterfaceInfoSize 指向的 DWORD 变量中返回。
 
 

要求

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

另请参阅

路由协议接口函数

路由协议接口参考

SetInterfaceInfo