共用方式為


ConvertInterfaceLuidToNameA 函式 (netioapi.h)

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

語法

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceLuidToNameA(
  [in]  const NET_LUID *InterfaceLuid,
  [out] PSTR           InterfaceName,
  [in]  SIZE_T         Length
);

參數

[in] InterfaceLuid

網路介面 NET_LUID 指標。

[out] InterfaceName

緩衝區的指標,用來保存函式傳回成功時包含介面名稱的 NULL終止 ANSI 字串。

[in] Length

InterfaceName 參數所指向之緩衝區的長度,以位元組為單位。 這個值必須夠大,才能容納介面名稱和終止的 Null 字元。 所需的長度上限 為 NDIS_IF_MAX_STRING_SIZE + 1。

傳回值

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

錯誤碼 意義
ERROR_INVALID_PARAMETER
其中一個參數無效。 如果 InterfaceLuid 或 InterfaceName 參數為 NULLInterfaceLuid 參數無效,則會傳回此錯誤。
ERROR_NOT_ENOUGH_MEMORY
沒有足夠的記憶體可用來處理此命令。 如果 InterfaceName 參數所指向的緩衝區大小不夠大,如 Length 參數中所指定,以保存介面名稱,就會傳回此錯誤。

備註

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

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

ConvertInterfaceLuidToNameW 會將網路介面 LUID 轉換為 Unicode 介面名稱。

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

規格需求

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

另請參閱

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID

if_indextoname

if_nametoindex