ConvertInterfaceLuidToGuid 函式 (netioapi.h)

發行項
02/29/2024

ConvertInterfaceLuidToGuid 函式會將網路介面的本機唯一標識碼 (LUID) 轉換為介面的全域唯一標識碼 (GUID) 。

語法

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceLuidToGuid(
  [in]  const NET_LUID *InterfaceLuid,
  [out] GUID           *InterfaceGuid
);

參數

[in] InterfaceLuid

網路介面 NET_LUID 指標。

[out] InterfaceGuid

這個介面之 GUID 的指標。

傳回值

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

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

備註

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

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

規格需求

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