Fungsi ConvertInterfaceLuidToNameW

Artikel
03/08/2023

Fungsi ConvertInterfaceLuidToNameW mengonversi pengidentifikasi unik lokal (LUID) untuk antarmuka jaringan ke nama antarmuka Unicode.

Catatan

Keluarga ConvertInterfaceXxx API menghitung pengidentifikasi di semua antarmuka yang terikat ke TCP/IP, yang mungkin mencakup miniport virtual, filter ringan, adaptor terowongan, dan antarmuka fisik.

Sintaks

NETIOAPI_API ConvertInterfaceLuidToNameW(
  _In_  const NET_LUID *InterfaceLuid,
  _Out_       PWSTR    InterfaceName,
  _In_        SIZE_T   Length
);

Parameter

InterfaceLuid [in]
Penunjuk ke serikat NET_LUID untuk antarmuka jaringan.
InterfaceName [out]
Penunjuk ke buffer untuk menahan string Unicode yang dihentikan NULL. Jika ConvertInterfaceLuidToNameW berhasil ditampilkan, InterfaceName berisi nama antarmuka Unicode.
Panjang [in]
Panjang buffer, menurut jumlah karakter, yang dirujuk oleh parameter InterfaceName . Nilai ini harus cukup besar untuk menahan nama antarmuka dan karakter NULL yang mengakhiri. Panjang maksimum yang diizinkan adalah NDIS_IF_MAX_STRING_SIZE + 1. Untuk informasi selengkapnya tentang NDIS_IF_MAX_STRING_SIZE, lihat bagian Keterangan berikut ini.

Nilai kembali

ConvertInterfaceLuidToNameW mengembalikan STATUS_SUCCESS jika fungsi berhasil. Jika fungsi gagal, ConvertInterfaceLuidToNameW mengembalikan salah satu kode kesalahan berikut:

Menampilkan kode	Deskripsi
STATUS_INVALID_PARAMETER	Salah satu parameter tidak valid. ConvertInterfaceLuidToNameW mengembalikan kesalahan ini jika InterfaceLuid atau InterfaceNameadalah NULL, atau jika InterfaceLuid tidak valid.
STATUS_NOT_ENOUGH_MEMORY	ConvertInterfaceLuidToNameW mengembalikan kesalahan ini jika buffer InterfaceName tidak sebesar yang ditentukan dalam parameter Panjang dan, oleh karena itu, buffer tidak dapat menahan nama antarmuka.

Keterangan

Fungsi ConvertInterfaceLuidToNameW independen protokol dan berfungsi dengan antarmuka jaringan untuk protokol IPv6 dan IPv4.

Panjang maksimum nama antarmuka jaringan, NDIS_IF_MAX_STRING_SIZE, tanpa karakter NULL yang mengakhiri, didefinisikan dalam file header Ntddndis.h. NDIS_IF_MAX_STRING_SIZE didefinisikan sebagai konstanta IF_MAX_STRING_SIZE, yang didefinisikan dalam file header Ifdef.h.

Catatan

File header Ntddndis.h dan Ifdef.h secara otomatis disertakan dalam file header Netioapi.h . Anda tidak boleh menggunakan file header Ntddndis.h dan Ifdef.h secara langsung.

Gunakan ConvertInterfaceLuidToNameA untuk mengonversi LUID antarmuka jaringan menjadi nama antarmuka ANSI.

Persyaratan

Platform target	Universal
Versi	Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Header	Netioapi.h (termasuk Netioapi.h)
Pustaka	Netio.lib
IRQL	PASSIVE_LEVEL