ConvertInterfaceNameToLuidA 函式 (netioapi.h)

發行項
02/29/2024

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

語法

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceNameToLuidA(
  [in]  const CHAR *InterfaceName,
  [out] NET_LUID   *InterfaceLuid
);

參數

[in] InterfaceName

包含網路介面名稱之 NULL 終止 ANSI 字串的指標。

[out] InterfaceLuid

這個介面之NET_LUID 的指標。

傳回值

成功時， ConvertInterfaceNameToLuidA 會傳回 NETIO_ERROR_SUCCESS。任何非零的傳回值都表示失敗。

錯誤碼	意義
ERROR_BUFFER_OVERFLOW	ANSI 介面名稱的長度無效。如果 InterfaceName 參數超過此參數允許的字串長度上限，就會傳回此錯誤。
ERROR_INVALID_NAME	介面名稱無效。如果 InterfaceName 參數包含無效的名稱，就會傳回此錯誤。
ERROR_INVALID_PARAMETER	其中一個參數無效。如果 InterfaceLuid 參數為 NULL，就會傳回此錯誤。

備註

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

ConvertInterfaceNameToLuidA 函式與通訊協議無關，可與 IPv6 和 IPv4 通訊協定的網路介面搭配使用。 ConvertInterfaceNameToLuidA 會將 ANSI 介面名稱轉換為 LUID。

ConvertInterfaceNameToLuidW 會將 Unicode 介面名稱轉換成 LUID。

在 Ntddndis.h 頭檔中宣告沒有終止 NULL 的介面名稱長度上限NDIS_IF_MAX_STRING_SIZE。 NDIS_IF_MAX_STRING_SIZE定義為 Ifdef.h 頭檔中定義的IF_MAX_STRING_SIZE常數。 Ntddndis.h 和 Ifdef.h 頭文件會自動包含在 Netioapi.h 頭檔中，Iphlpapi.h 頭文件會自動包含此頭檔。不應該直接使用 Ntddndis.h、 Ifdef.h 和 Netioapi.h 頭檔。

規格需求

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