ConvertInterfaceIndexToLuid 函式 (netioapi.h)

發行項
02/29/2024

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

語法

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceIndexToLuid(
  [in]  NET_IFINDEX InterfaceIndex,
  [out] PNET_LUID   InterfaceLuid
);

參數

[in] InterfaceIndex

網路介面的本機索引值。

[out] InterfaceLuid

這個介面之NET_LUID 的指標。

傳回值

成功時， ConvertInterfaceIndexToLuid 會傳回NO_ERROR。任何非零傳回值都表示失敗，並在 InterfaceLuid 參數中傳回 NULL。

錯誤碼	意義
ERROR_FILE_NOT_FOUND	系統找不到指定的檔案。如果 InterfaceIndex 參數指定的網路介面不是本機電腦上的值，就會傳回此錯誤。
ERROR_INVALID_PARAMETER	其中一個參數無效。如果 InterfaceLuid 參數為 NULL 或 InterfaceIndex 參數無效，則會傳回此錯誤。

備註

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

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

規格需求

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