ConvertInterfaceGuidToLuid 函式 (netioapi.h)

發行項
03/05/2024

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

語法

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

參數

[in] InterfaceGuid

網路介面之 GUID 的指標。

[out] InterfaceLuid

這個介面之NET_LUID 的指標。

傳回值

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

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

備註

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

ConvertInterfaceGuidToLuid 函式與通訊協議無關，適用於 IPv6 和 IPv4 通訊協定的網路介面。

規格需求

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