getPerAdapterInfo 函数 (iphlpapi.h)

  • 项目

GetPerAdapterInfo 函数检索与指定接口对应的适配器的相关信息。

语法

IPHLPAPI_DLL_LINKAGE DWORD GetPerAdapterInfo(
  [in]  ULONG                IfIndex,
  [out] PIP_PER_ADAPTER_INFO pPerAdapterInfo,
  [in]  PULONG               pOutBufLen
);

参数

[in] IfIndex

接口的索引。 GetPerAdapterInfo 函数检索与此接口对应的适配器的信息。

[out] pPerAdapterInfo

指向接收有关适配器信息的 IP_PER_ADAPTER_INFO 结构的指针。

[in] pOutBufLen

指向 ULONG 变量的指针，该变量指定 IP_PER_ADAPTER_INFO 结构的大小。 如果此大小不足以保存信息， 则 GetPerAdapterInfo 会用所需的大小填充此变量，并返回ERROR_BUFFER_OVERFLOW的错误代码。

返回值

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

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

返回代码 说明
ERROR_BUFFER_OVERFLOW
 pOutBufLen 参数指示的缓冲区大小太小，无法保存适配器信息。 pOutBufLen 参数指向所需的大小。
ERROR_INVALID_PARAMETER
 pOutBufLen 参数为 NULL，或者调用进程对 pOutBufLen 指向的内存没有读/写访问权限，或者调用进程对 pAdapterInfo 参数指向的内存没有写入访问权限。
ERROR_NOT_SUPPORTED

本地计算机上运行的操作系统不支持 GetPerAdapterInfo。
其他
 如果函数失败，请使用 FormatMessage 获取返回错误的消息字符串。
 
 

注解

适配器索引可能会在禁用然后启用适配器时发生更改，或者在其他情况下，不应被视为永久性。

要求

要求 值
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 iphlpapi.h
Library Iphlpapi.lib
DLL Iphlpapi.dll

另请参阅

IP 帮助程序函数参考

IP 帮助程序起始页

IP_PER_ADAPTER_INFO