Fungsi ConvertInterfaceLuidToNameW (netioapi.h)

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

Sintaks

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceLuidToNameW(
  [in]  const NET_LUID *InterfaceLuid,
  [out] PWSTR          InterfaceName,
  [in]  SIZE_T         Length
);

Parameter

[in] InterfaceLuid

Pointer ke NET_LUID untuk antarmuka jaringan.

[out] InterfaceName

Penunjuk ke buffer untuk menahan string Unicode yang dihentikan NULL yang berisi nama antarmuka saat fungsi berhasil dikembalikan.

[in] Length

Jumlah karakter dalam array yang ditujukkan oleh parameter InterfaceName . Nilai ini harus cukup besar untuk mengakomodasi nama antarmuka dan karakter null yang mengakhiri. Panjang maksimum yang diperlukan adalah NDIS_IF_MAX_STRING_SIZE + 1.

Nilai kembali

Setelah berhasil, ConvertInterfaceLuidToNameW mengembalikan NETIO_ERROR_SUCCESS. Nilai pengembalian bukan nol menunjukkan kegagalan.

Kode kesalahan	Makna
ERROR_INVALID_PARAMETER	Salah satu parameter tidak valid. Kesalahan ini dikembalikan jika parameter InterfaceLuid atau InterfaceNameNULL atau jika parameter InterfaceLuid tidak valid.
ERROR_NOT_ENOUGH_MEMORY	Penyimpanan tidak cukup tersedia untuk memproses perintah ini. Kesalahan ini dikembalikan jika ukuran buffer yang ditunjukkan oleh parameter InterfaceName tidak cukup besar seperti yang ditentukan dalam parameter Panjang untuk menahan nama antarmuka.

Keterangan

Fungsi ConvertInterfaceLuidToNameW tersedia di Windows Vista dan yang lebih baru.

Fungsi ConvertInterfaceLuidToNameW adalah protokol independen dan bekerja dengan antarmuka jaringan untuk protokol IPv6 dan IPv4. ConvertInterfaceLuidToNameW mengonversi LUID antarmuka jaringan menjadi nama antarmuka Unicode.

ConvertInterfaceLuidToNameA mengonversi nama antarmuka ANSI menjadi LUID.

Panjang maksimum nama antarmuka, NDIS_IF_MAX_STRING_SIZE, tanpa PENGHENTIAN NULL dinyatakan dalam file header Ntddndis.h . NDIS_IF_MAX_STRING_SIZE didefinisikan sebagai konstanta IF_MAX_STRING_SIZE yang ditentukan dalam file header Ifdef.h. File header Ntddndis.h dan Ifdef.h secara otomatis disertakan dalam file header Netioapi.h yang secara otomatis disertakan oleh file header Iphlpapi.h . File header Ntddndis.h, Ifdef.h, dan Netioapi.h tidak boleh digunakan secara langsung.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	netioapi.h (termasuk Iphlpapi.h)
Pustaka	Iphlpapi.lib
DLL	Iphlpapi.dll

Lihat juga

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID

if_indextoname

if_nametoindex