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