DOT11EXTIHV_PERFORM_PRE_ASSOCIATE fungsi panggilan balik (wlanihv.h)

Artikel
08/08/2023

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 Dot11ExtIhvPerformPreAssociate untuk meminta agar DLL Ekstensi IHV memulai operasi pra-asosiasi dengan jaringan set layanan dasar (BSS).

Sintaks

DOT11EXTIHV_PERFORM_PRE_ASSOCIATE Dot11extihvPerformPreAssociate;

DWORD Dot11extihvPerformPreAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] HANDLE hConnectSession,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [in]           PDOT11_BSS_LIST pConnectableBssid,
  [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] hConnectSession

Handel yang digunakan oleh sistem operasi untuk mereferensikan sesi koneksi dengan jaringan set layanan dasar (BSS).

[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 menentukan pengaturan keamanan untuk profil IHV.

[in] pConnectableBssid

Penunjuk ke struktur DOT11_BSS_LIST , yang berisi satu atau lebih bingkai Beacon atau Probe Response 802.11 untuk pengidentifikasi set layanan (SSID) jaringan BSS tempat DLL akan melakukan operasi pra-asosiasi.

[out] pdwReasonCode

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

Nilai kembali

Jika DLL Ekstensi IHV dapat memulai operasi pra-asosiasi, dll harus menyelesaikan operasi secara asinkron. Dalam situasi ini, fungsi mengembalikan ERROR_SUCCESS.

Jika DLL Ekstensi IHV tidak dapat memulai operasi pra-asosiasi, ia mengembalikan kode kesalahan yang ditentukan dalam Winerror.h.

Keterangan

Sistem operasi memanggil fungsi Dot11ExtIhvPerformPreAssociate untuk memulai operasi pra-asosiasi dengan DLL Ekstensi IHV. Sistem operasi memulai operasi ini sebelum memulai operasi koneksi dengan jaringan set layanan dasar (BSS) melalui adaptor WLAN. Untuk informasi selengkapnya tentang operasi koneksi, lihat Operasi Koneksi.

Operasi pra-asosiasi harus diselesaikan secara asinkron dari panggilan ke Dot11ExtIhvPerformPreAssociate. Setelah operasi pra-asosiasi selesai, DLL Ekstensi IHV harus memanggil Dot11ExtPreAssociateCompletion.

Ketika fungsi Dot11ExtIhvPerformPreAssociate dipanggil, DLL Ekstensi IHV harus mengikuti panduan ini.

Jika DLL Ekstensi IHV dapat memulai operasi pra-asosiasi, fungsi Dot11ExtIhvPerformPreAssociate harus mengembalikan ERROR_SUCCESS dan menyelesaikan operasi secara asinkron.
DLL Ekstensi IHV memberikan informasi lebih lanjut mengenai inisiasi operasi pra-asosiasi melalui parameter pdwReasonCode . DLL harus mengatur * pdwReasonCode ke salah satu hal berikut:
- L2_REASON_CODE_SUCCESS, jika operasi pra-asosiasi dapat berhasil dimulai.
- Nilai kesalahan L2_REASON_CODE_xxxx yang sesuai, jika operasi pra-asosiasi tidak dapat dimulai.
- 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 apakah operasi pra-asosiasi dapat dimulai atau tidak.

Untuk informasi selengkapnya tentang operasi pra-asosiasi, lihat Operasi Pra-Asosiasi.

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)