Fungsi ConvertInterfaceLuidToAlias (netioapi.h)
Fungsi ConvertInterfaceLuidToAlias mengonversi pengidentifikasi unik lokal (LUID) untuk antarmuka jaringan ke alias antarmuka.
Sintaks
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceLuidToAlias(
[in] const NET_LUID *InterfaceLuid,
[out] PWSTR InterfaceAlias,
[in] SIZE_T Length
);
Parameter
[in] InterfaceLuid
Penunjuk ke NET_LUID untuk antarmuka jaringan.
[out] InterfaceAlias
Penunjuk ke buffer untuk menahan string Unicode yang dihentikan NULL yang berisi nama alias antarmuka jaringan saat fungsi berhasil dikembalikan.
[in] Length
Panjang, dalam karakter, dari buffer yang diacu oleh parameter InterfaceAlias . Nilai ini harus cukup besar untuk mengakomodasi nama alias antarmuka jaringan dan karakter NULL yang mengakhiri. Panjang maksimum yang diperlukan adalah NDIS_IF_MAX_STRING_SIZE + 1.
Nilai kembali
Setelah berhasil, ConvertInterfaceLuidToAlias mengembalikan NO_ERROR. Nilai pengembalian bukan nol menunjukkan kegagalan.
Kode kesalahan | Makna |
---|---|
|
Salah satu parameter tidak valid. Kesalahan ini dikembalikan jika parameter InterfaceLuid atau InterfaceAlias adalah NULL atau jika parameter InterfaceLuid tidak valid. |
|
Penyimpanan tidak cukup tersedia untuk memproses perintah ini. Kesalahan ini dikembalikan jika ukuran buffer yang ditunjukkan oleh parameter InterfaceAlias tidak cukup besar seperti yang ditentukan dalam parameter Panjang untuk menahan nama alias. |
Keterangan
Fungsi ConvertInterfaceLuidToAlias tersedia di Windows Vista dan yang lebih baru.
Fungsi ConvertInterfaceLuidToAlias adalah protokol independen dan bekerja dengan antarmuka jaringan untuk protokol IPv6 dan IPv4.
Panjang maksimum nama alias untuk antarmuka jaringan, NDIS_IF_MAX_STRING_SIZE, tanpa NULL yang mengakhiri 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 |