Fungsi ConvertInterfaceNameToLuidA (netioapi.h)
Fungsi ConvertInterfaceNameToLuidA mengonversi nama antarmuka jaringan ANSI menjadi pengidentifikasi unik lokal (LUID) untuk antarmuka.
Sintaks
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceNameToLuidA(
[in] const CHAR *InterfaceName,
[out] NET_LUID *InterfaceLuid
);
Parameter
[in] InterfaceName
Penunjuk ke string ANSI yang dihentikan NULL yang berisi nama antarmuka jaringan.
[out] InterfaceLuid
Penunjuk ke NET_LUID untuk antarmuka ini.
Nilai kembali
Setelah berhasil, ConvertInterfaceNameToLuidA mengembalikan NETIO_ERROR_SUCCESS. Nilai pengembalian bukan nol menunjukkan kegagalan.
Kode kesalahan | Makna |
---|---|
|
Panjang nama antarmuka ANSI tidak valid. Kesalahan ini dikembalikan jika parameter InterfaceName melebihi panjang string maksimum yang diizinkan untuk parameter ini. |
|
Nama antarmuka tidak valid. Kesalahan ini dikembalikan jika parameter InterfaceName berisi nama yang tidak valid. |
|
Salah satu parameter tidak valid. Kesalahan ini dikembalikan jika parameter InterfaceLuidadalah NULL. |
Keterangan
Fungsi ConvertInterfaceNameToLuidA tersedia di Windows Vista dan yang lebih baru.
Fungsi ConvertInterfaceNameToLuidA adalah protokol independen dan bekerja dengan antarmuka jaringan untuk protokol IPv6 dan IPv4. ConvertInterfaceNameToLuidA mengonversi nama antarmuka ANSI menjadi LUID.
ConvertInterfaceNameToLuidW mengonversi nama antarmuka Unicode 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 |