Fungsi ConvertInterfaceLuidToAlias
Fungsi ConvertInterfaceLuidToAlias mengonversi pengidentifikasi unik lokal (LUID) untuk antarmuka jaringan ke alias antarmuka.
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 ConvertInterfaceLuidToAlias(
_In_ const NET_LUID *InterfaceLuid,
_Out_ PWSTR InterfaceAlias,
_In_ SIZE_T Length
);
Parameter
InterfaceLuid [in]
Penunjuk ke serikat NET_LUID untuk antarmuka jaringan.InterfaceAlias [out]
Penunjuk ke buffer untuk menahan string Unicode yang dihentikan NULL. Jika ConvertInterfaceLuidToAlias berhasil dikembalikan, InterfaceAlias berisi nama alias antarmuka jaringan.Panjang [in]
Panjangnya, menurut jumlah karakter, dari buffer yang dirujuk oleh parameter InterfaceAlias . Nilai ini harus cukup besar untuk menahan nama alias antarmuka jaringan 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
ConvertInterfaceLuidToAlias mengembalikan STATUS_SUCCESS jika fungsi berhasil. Jika fungsi gagal, ConvertInterfaceLuidToAlias mengembalikan salah satu kode kesalahan berikut:
Menampilkan kode | Deskripsi |
---|---|
STATUS_INVALID_PARAMETER | Salah satu parameter tidak valid. ConvertInterfaceLuidToAlias mengembalikan kesalahan ini jika InterfaceLuid atau InterfaceAliasadalah NULL, atau jika InterfaceLuid tidak valid. |
STATUS_NOT_ENOUGH_MEMORY | Penyimpanan tidak cukup tersedia. ConvertInterfaceLuidToAlias mengembalikan kesalahan ini jika ukuran buffer yang ditunjuk parameter InterfaceAlias tidak sebesar yang ditentukan dalam parameter Panjang dan, oleh karena itu, buffer tidak dapat menahan nama alias. |
Keterangan
Fungsi ConvertInterfaceLuidToAlias independen protokol dan berfungsi dengan antarmuka jaringan untuk protokol IPv6 dan IPv4.
Panjang maksimum nama alias untuk antarmuka jaringan, NDIS_IF_MAX_STRING_SIZE, tanpa karakter NULL yang mengakhiri, dinyatakan 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.
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 |