if_nametoindex函式
if_nametoindex 函式會將網路介面的 ANSI 介面名稱轉換為介面的本機索引。
語法
NET_IFINDEX NETIOAPI_API_ if_nametoindex(
_In_ PCSTR InterfaceName
);
參數
-
InterfaceName [in]
包含介面名稱之 NULL 終止 ANSI 字串的指標。
傳回值
如果函式成功，if_nametoindex 會傳回本機介面索引。 如果函式失敗，if_nametoindex 會傳回零。
言論
if_nametoindex 函式會將介面名稱對應至其對應的索引。 此函式是設計為 IPv6 的基本套接字延伸模組的一部分，如 RFC 2553中的 IETF 所述。
if_nametoindex 函式是針對具有 Unix 環境的驅動程式可移植性所實作，但 ConvertInterfaceXxx 函式是轉換網路介面識別碼的慣用方法。 您可以藉由呼叫 ConvertInterfaceNameToLuidA 函式來取代 if_nametoindex 函式，將 ANSI 介面名稱轉換成 NET_LUID 聯集，然後呼叫 ConvertInterfaceLuidToIndex 函式，將NET_LUID轉換成本機介面索引。
如果 if_nametoindex 函式失敗並傳回零，則無法判斷錯誤碼。
要求
目標平臺 |
通用 |
版本 |
可在 Windows Vista 和更新版本的 Windows作系統中使用。 |
頁眉 |
Netioapi.h （包括 Netioapi.h） |
圖書館 |
Netio.lib |
IRQL |
PASSIVE_LEVEL |