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 |
| 程式庫 | Iphlpapi.lib |
| Dll | Iphlpapi.dll |