ConvertInterfaceNameToLuidA 函式
ConvertInterfaceNameToLuidA函式會將 ANSI 網路介面名稱轉換為介面的本機唯一識別碼 (LUID) 。
注意
ConvertInterfaceXxx API 系列會列舉系結至 TCP/IP 之所有介面的識別碼，其中可能包含虛擬迷你埠、輕量型篩選器、通道介面卡和實體介面。
語法
NETIOAPI_API ConvertInterfaceNameToLuidA(
_In_ const CHAR *InterfaceName,
_Out_ NET_LUID *InterfaceLuid
);
參數
InterfaceName [in]
包含網路介面名稱之 Null 終止 ANSI 字串的指標。InterfaceLuid [out]
這個介面 之NET_LUID 聯集的指標。
傳回值
ConvertInterfaceNameToLuidA 會在函式成功時傳回STATUS_SUCCESS。 如果函式失敗， ConvertInterfaceNameToLuidA 會傳回下列其中一個錯誤碼：
| 傳回碼 | 描述 |
|---|---|
| ERROR_BUFFER_OVERFLOW | ANSI 介面名稱的長度無效。 ConvertInterfaceNameToLuidA 如果 InterfaceName 參數超過此參數允許的最大字串長度，則會傳回此錯誤。 |
| STATUS_INVALID_NAME | 介面名稱無效。 ConvertInterfaceNameToLuidA 如果 InterfaceName 參數包含不正確介面名稱，則會傳回此錯誤。 |
| STATUS_INVALID_PARAMETER | 其中一個參數無效。 ConvertInterfaceNameToLuidA 如果 InterfaceLuid 參數為 Null，就會傳回此錯誤。 |
備註
ConvertInterfaceNameToLuidA函式與通訊協定無關，適用于 IPv6 和 IPv4 通訊協定的網路介面。
在 Ntddndis.h 標頭檔中定義網路介面名稱的最大長度，NDIS_IF_MAX_STRING_SIZE不含終止 Null。 NDIS_IF_MAX_STRING_SIZE定義為 IF_MAX_STRING_SIZE 常數，該常數定義于 Ifdef.h 標頭檔中。
注意
Netioapi.h標頭檔中會自動包含Ntddndis.h和Ifdef.h標頭檔。 您絕對不應該直接使用 Ntddndis.h 和 Ifdef.h 標頭檔。
使用 ConvertInterfaceNameToLuidW 函式，將 Unicode 介面名稱轉換為 LUID。
規格需求
目標平台 |
普遍 |
版本 |
可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
標頭 |
Netioapi.h (包含 Netioapi.h) |
程式庫 |
Netio.lib |
IRQL |
PASSIVE_LEVEL |