DOT11EXTIHV_VALIDATE_PROFILE fungsi panggilan balik (wlanihv.h)

Artikel
02/27/2024

Penting Antarmuka LAN Nirkabel Native 802.11 tidak digunakan lagi di Windows 10 dan yang lebih baru. Silakan gunakan WLAN Device Driver Interface (WDI) sebagai gantinya. Untuk informasi selengkapnya tentang WDI, lihat WLAN Universal Windows driver model.

Sistem operasi memanggil fungsi Dot11ExtIhvValidateProfile untuk memvalidasi data pengguna yang dimasukkan untuk profil jaringan. DLL Ekstensi IHV hanya bertanggung jawab untuk memverifikasi data untuk fragmen konektivitas dan profil keamanan yang ditentukan oleh IHV.

Sintaks

DOT11EXTIHV_VALIDATE_PROFILE Dot11extihvValidateProfile;

DWORD Dot11extihvValidateProfile(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [out]          PDWORD pdwReasonCode
)
{...}

Parameter

[in, optional] hIhvExtAdapter

Handel yang digunakan oleh DLL Ekstensi IHV untuk mereferensikan adaptor LAN nirkabel (WLAN). Nilai handel ini ditentukan melalui panggilan sebelumnya ke fungsi Dot11ExtIhvInitAdapter IHV Handler.

[in, optional] pIhvProfileParams

Penunjuk ke DOT11EXT_IHV_PROFILE_PARAMS struktur. Struktur ini mendefinisikan atribut jaringan set layanan dasar (BSS) tempat ekstensi profil akan diterapkan.

[in] pIhvConnProfile

Penunjuk ke DOT11EXT_IHV_CONNECTIVITY_PROFILE struktur yang berisi pengaturan konektivitas untuk profil IHV.

[in] pIhvSecProfile

Penunjuk ke DOT11EXT_IHV_SECURITY_PROFILE struktur yang berisi pengaturan keamanan untuk profil IHV.

[out] pdwReasonCode

Penunjuk ke nilai DWORD, yang menyediakan informasi tambahan untuk nilai pengembalian fungsi Dot11ExtIhvValidateProfile . DLL Ekstensi IHV harus mengatur * pdwReasonCode ke nilai L2_REASON_CODE_xxxx, yang ditentukan dalam L2cmn.h.

Nilai kembali

Jika panggilan berhasil, fungsi akan mengembalikan ERROR_SUCCESS. Jika tidak, ia mengembalikan kode kesalahan yang ditentukan dalam Winerror.h.

Keterangan

Sistem operasi memanggil fungsi Dot11ExtIhvValidateProfile untuk memverifikasi pengaturan yang ditentukan pengguna untuk profil jaringan sebelum profil diproses atau disimpan.

Ketika fungsi Dot11ExtIhvValidateProfile dipanggil, DLL Ekstensi IHV mengikuti panduan berikut:

DLL Ekstensi IHV memverifikasi bahwa pengaturan profil yang ditentukan pengguna valid untuk atribut umum jaringan set layanan dasar (BSS) tempat profil akan diterapkan. Atribut jaringan BSS dirujuk melalui parameter pIhvProfileParams .
Jika data pengguna valid untuk ekstensi profil jaringan, Dot11ExtIhvValidateProfile harus mengembalikan ERROR_SUCCESS. Jika tidak, fungsi harus mengembalikan kode kesalahan yang sesuai dari nilai ERROR_xxxx yang ditentukan dalam Winerror.h.
DLL Ekstensi IHV memberikan informasi lebih lanjut mengenai hasil validasi data pengguna. DLL harus mengatur * pdwReasonCode ke salah satu hal berikut:
- L2_REASON_CODE_SUCCESS, jika data pengguna valid.
- Nilai kesalahan L2_REASON_CODE_xxxx yang sesuai, jika data pengguna tidak valid.
- Nilai yang ditentukan IHV dalam rentang dari L2_REASON_CODE_IHV_BASE hingga (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1), terlepas dari validitas data pengguna.

Untuk informasi selengkapnya tentang skema XML Native 802.11, lihat dokumentasi Microsoft Windows SDK.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Desktop
Header	wlanihv.h (termasuk Wlanihv.h, L2cmn.h)

Lihat juga

DOT11EXT_IHV_CONNECTIVITY_PROFILE

DOT11EXT_IHV_PROFILE_PARAMS

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE

Share via