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。
如果函数失败,则返回值为以下错误代码之一。
值 | 说明 |
---|---|
|
尝试检索信息失败。 |
|
InterfaceIndex 参数无效 (例如,不存在具有该索引) 的接口,或者 InterfaceInfoSize 参数为 NULL。 |
|
提供的输出缓冲区的大小不足以保存请求的信息。 所需大小在 InterfaceInfoSize 指向的 DWORD 变量中返回。 |
要求 | 值 |
---|---|
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | routprot.h |