ConvertInterfaceLuidToAlias 函式
ConvertInterfaceLuidToAlias函式會將網路介面的本機唯一識別碼 (LUID) 轉換為介面別名。
注意
ConvertInterfaceXxx API 系列會列舉系結至 TCP/IP 之所有介面的識別碼，其中可能包含虛擬迷你埠、輕量型篩選器、通道介面卡和實體介面。
語法
NETIOAPI_API ConvertInterfaceLuidToAlias(
_In_ const NET_LUID *InterfaceLuid,
_Out_ PWSTR InterfaceAlias,
_In_ SIZE_T Length
);
參數
InterfaceLuid [in]
網路介面 NET_LUID 聯集的指標。InterfaceAlias [out]
要保存 Null 終止 Unicode 字串之緩衝區的指標。 如果 ConvertInterfaceLuidToAlias 傳回成功， InterfaceAlias 會包含網路介面的別名名稱。長度 [in]
InterfaceAlias參數所指向緩衝區的長度，依字元計數。 這個值必須夠大，才能保存網路介面的別名名稱和終止的 Null 字元。 允許的最大長度為 NDIS_IF_MAX_STRING_SIZE + 1。 如需NDIS_IF_MAX_STRING_SIZE的詳細資訊，請參閱下列一節。
傳回值
ConvertInterfaceLuidToAlias 會在函式成功時傳回STATUS_SUCCESS。 如果函式失敗， ConvertInterfaceLuidToAlias 會傳回下列其中一個錯誤碼：
| 傳回碼 | 描述 |
|---|---|
| STATUS_INVALID_PARAMETER | 其中一個參數無效。 ConvertInterfaceLuidToAlias 如果 InterfaceLuid 或 InterfaceAlias 為 Null，或 InterfaceLuid 無效，則會傳回此錯誤。 |
| STATUS_NOT_ENOUGH_MEMORY | 沒有足夠的儲存體可用。 ConvertInterfaceLuidToAlias 如果 InterfaceAlias 參數指向的緩衝區大小與 Length 參數中指定的大小不相同，因此緩衝區無法保存別名名稱，就會傳回此錯誤。 |
備註
ConvertInterfaceLuidToAlias函式與通訊協定無關，適用于 IPv6 和 IPv4 通訊協定的網路介面。
網路介面的別名名稱長度上限，NDIS_IF_MAX_STRING_SIZE，不含終止的 Null 字元，會在 Ntddndis.h 標頭檔中宣告。 NDIS_IF_MAX_STRING_SIZE定義為 IF_MAX_STRING_SIZE 常數，該常數定義于 Ifdef.h 標頭檔中。
注意
Netioapi.h標頭檔中會自動包含Ntddndis.h和Ifdef.h標頭檔。 您絕對不應該直接使用 Ntddndis.h 和 Ifdef.h 標頭檔。
規格需求
目標平台 |
普遍 |
版本 |
可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
標頭 |
Netioapi.h (包含 Netioapi.h) |
程式庫 |
Netio.lib |
IRQL |
PASSIVE_LEVEL |