ConvertInterfaceAliasToLuid 函式
ConvertInterfaceAliasToLuid函式會將網路介面的介面別名名稱轉換為介面的本機唯一識別碼 (LUID) 。
注意
ConvertInterfaceXxx API 系列會列舉系結至 TCP/IP 之所有介面的識別碼，其中可能包含虛擬迷你埠、輕量型篩選器、通道介面卡和實體介面。
語法
NETIOAPI_API ConvertInterfaceAliasToLuid(
_In_ const WCHAR *InterfaceAlias,
_Out_ PNET_LUID InterfaceLuid
);
參數
InterfaceAlias [in]
Null 終止 Unicode 字串的指標，其中包含網路介面的別名名稱。InterfaceLuid [out]
網路介面 NET_LUID 聯集的指標。
傳回值
ConvertInterfaceAliasToLuid 會在函式成功時傳回STATUS_SUCCESS。 如果函式失敗， InterfaceLuid 參數會設定為 Null，而 ConvertInterfaceAliasToLuid 會傳回下列錯誤碼：
| 傳回碼 | 描述 |
|---|---|
| STATUS_INVALID_PARAMETER | 其中一個參數無效。 ConvertInterfaceAliasToLuid 如果 InterfaceAlias或InterfaceLuid為Null，或InterfaceAlias無效，則會傳回此錯誤。 |
備註
ConvertInterfaceAliasToLuid函式與通訊協定無關，適用于 IPv6 和 IPv4 通訊協定的網路介面。
規格需求
目標平台 |
普遍 |
版本 |
可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
標頭 |
Netioapi.h (包含 Netioapi.h) |
程式庫 |
Netio.lib |
IRQL |
PASSIVE_LEVEL |