共用方式為


if_indextoname函式 (netioapi.h)

if_indextoname函式會將網路介面的本機索引轉換為 ANSI 介面名稱。

語法

IPHLPAPI_DLL_LINKAGE PCHAR NETIOAPI_API_ if_indextoname(
  [in]  NET_IFINDEX InterfaceIndex,
  [out] PCHAR       InterfaceName
);

參數

[in] InterfaceIndex

網路介面的本機索引。

[out] InterfaceName

緩衝區的指標,用來保存函式傳回成功時包含介面名稱的 NULL終止 ANSI 字串。 此參數所指向之緩衝區的長度,以位元組為單位必須等於或大於 IF_NAMESIZE

傳回值

成功時, if_indextoname 傳回包含介面名稱的 NULL終止 ANSI 字串指標。 失敗時,會傳回 NULL 指標。

備註

Windows Vista 和更新版本提供 if_indextoname 函式。

if_indextoname函式會將介面索引對應至其對應名稱。 此函式是設計為 IPv6 的基本套接字延伸模組的一部分,如 RFC 2553 中的 IETF 所述。 如需詳細資訊,請參閱http://www.ietf.org/rfc/rfc2553.txt

if_indextoname函式是針對具有 Unix 環境的應用程式可移植性所實作,但建議使用 ConvertInterface 函式。 if_indextoname函式可以取代為 ConvertInterfaceIndexToLuid 函式的呼叫,將介面索引轉換成NET_LUID,後面接著對 ConvertInterfaceLuidToNameA 的呼叫,將NET_LUID轉換成 ANSI 介面名稱。

如果 if_indextoname 失敗並傳回 NULL 指標,則無法判斷錯誤碼。

InterfaceName 參數指向之緩衝區的長度,以位元組為單位必須等於或大於 IF_NAMESIZE,Netioapi.h 頭檔中所宣告的值等於 NDIS_IF_MAX_STRING_SIZENtddndis.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

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID

if_nametoindex