GetAdapterIndex 函数 (iphlpapi.h)

GetAdapterIndex 函数获取适配器的索引（给定其名称）。

语法

IPHLPAPI_DLL_LINKAGE DWORD GetAdapterIndex(
  [in]      LPWSTR AdapterName,
  [in, out] PULONG IfIndex
);

[in] AdapterName

指向 Unicode 字符串的指针，该字符串指定适配器的名称。

[in, out] IfIndex

指向指向适配器索引的 ULONG 变量的指针。

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

如果函数失败，请使用 FormatMessage 获取返回错误的消息字符串。

在适配器完全禁用之前， GetAdapterIndex 函数将适配器报告为存在。例如， NotifyAddrChange 函数可能指示删除了最近禁用的适配器的 IP 地址，但 GetAdapterIndex 会继续报告适配器索引，直到禁用适配器的过程完成。

当系统上存在一个或多个适配器时，当查询的适配器不存在时， GetAdapterIndex 将返回ERROR_DEV_NOT_EXIST。如果没有适配器， GetAdapterIndex 函数将返回ERROR_NO_DATA。

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

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