ConvertInterfaceLuidToIndex 函式 (netioapi.h)

發行項
03/05/2024

ConvertInterfaceLuidToIndex 函式會將網路介面的本機唯一標識碼 (LUID) 轉換為介面的本機索引。

語法

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceLuidToIndex(
  [in]  const NET_LUID *InterfaceLuid,
  [out] PNET_IFINDEX   InterfaceIndex
);

參數

[in] InterfaceLuid

網路介面 NET_LUID 的指標。

[out] InterfaceIndex

介面的本機索引值。

傳回值

成功時， ConvertInterfaceLuidToIndex 會傳回NO_ERROR。任何非零的傳回值都表示失敗，而且 InterfaceIndex 參數中會傳回NET_IFINDEX_UNSPECIFIED。

錯誤碼	意義
ERROR_INVALID_PARAMETER	其中一個參數無效。如果 InterfaceLuid 或 InterfaceIndex 參數為 NULL 或 InterfaceLuid 參數無效，則會傳回此錯誤。

備註

ConvertInterfaceLuidToIndex 函式可在 Windows Vista 和更新版本上使用。

ConvertInterfaceLuidToIndex 函式與通訊協議無關，可與 IPv6 和 IPv4 通訊協定的網路介面搭配使用。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	netioapi.h (包含 Iphlpapi.h)
程式庫	Iphlpapi.lib
Dll	Iphlpapi.dll