ConvertInterfaceAliasToLuid 函式 (netioapi.h)

發行項
03/05/2024

ConvertInterfaceAliasToLuid 函式會將網路介面的介面別名名稱轉換為介面的本機唯一標識碼 (LUID) 。

語法

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceAliasToLuid(
  [in]  const WCHAR *InterfaceAlias,
  [out] PNET_LUID   InterfaceLuid
);

參數

[in] InterfaceAlias

NULL 終止 Unicode 字串的指標，其中包含網路介面的別名名稱。

[out] InterfaceLuid

這個介面之NET_LUID 的指標。

傳回值

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

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

備註

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

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

規格需求

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