ConvertInterfaceNameToLuidW 函式 (netioapi.h)
ConvertInterfaceNameToLuidW 函式會將 Unicode 網路介面名稱轉換為介面的本機唯一標識碼 (LUID) 。
語法
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceNameToLuidW(
[in] const WCHAR *InterfaceName,
[out] NET_LUID *InterfaceLuid
);
參數
[in] InterfaceName
包含網路介面名稱之 NULL 終止 Unicode 字串的指標。
[out] InterfaceLuid
這個介面 之NET_LUID 的指標。
傳回值
成功時， ConvertInterfaceNameToLuidW 會傳回 NETIO_ERROR_SUCCESS。 任何非零的傳回值都表示失敗。
| 錯誤碼 | 意義 |
|---|---|
|
介面名稱無效。 如果 InterfaceName 參數包含無效的名稱或 InterfaceName 參數的長度超過此參數允許的字串長度上限，就會傳回此錯誤。 |
|
其中一個參數無效。 如果 InterfaceLuid 參數為 NULL，就會傳回此錯誤。 |
備註
ConvertInterfaceNameToLuidW 函式可在 Windows Vista 和更新版本上使用。
ConvertInterfaceNameToLuidW 函式與通訊協議無關，可與 IPv6 和 IPv4 通訊協定的網路介面搭配使用。 ConvertInterfaceNameToLuidW 會將 Unicode 介面名稱轉換成 LUID。
ConvertInterfaceNameToLuidA 會將 ANSI 介面名稱轉換為 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 |