Fungsi ConvertInterfaceLuidToNameA

Fungsi ConvertInterfaceLuidToNameA mengonversi pengidentifikasi unik lokal (LUID) untuk antarmuka jaringan ke nama antarmuka ANSI.

Nota

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.

Sintaksis

NETIOAPI_API ConvertInterfaceLuidToNameA(
  _In_  const NET_LUID *InterfaceLuid,
  _Out_       PSTR     InterfaceName,
  _In_        SIZE_T   Length
);

Parameter

• InterfaceLuid [in]
  Penunjuk ke serikat NET_LUID untuk antarmuka jaringan.

• InterfaceName [out]
  Penunjuk ke buffer untuk menahan string ANSI yang dihentikan NULL. Jika ConvertInterfaceLuidToNameA berhasil dikembalikan, InterfaceName berisi nama antarmuka ANSI.

• Panjang [in]
  Panjangnya, dalam byte, dari buffer yang dirujuk 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.

Mengembalikan nilai

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

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

Komentar

Fungsi ConvertInterfaceLuidToNameA bersifat independen protokol dan bekerja dengan antarmuka jaringan untuk protokol IPv6 dan IPv4.

Panjang maksimum nama untuk antarmuka jaringan, NDIS_IF_MAX_STRING_SIZE, tanpa mengakhiri karakter NULL, 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.

Nota

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

Gunakan fungsiConvertInterfaceLuidToNameW untuk mengonversi LUID antarmuka jaringan ke nama antarmuka Unicode.

Persyaratan

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

Lihat juga

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID