DOT11EXT_PRE_ASSOCIATE_COMPLETION fungsi panggilan balik (wlanihv.h)

  • Artikel
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.
 
DLL Ekstensi IHV memanggil fungsi Dot11ExtPreAssociateCompletion untuk menyelesaikan operasi pra-asosiasi yang dimulai secara asinkron melalui panggilan ke Dot11ExtIhvPerformPreAssociate Fungsi Handler IHV.

Sintaks

DOT11EXT_PRE_ASSOCIATE_COMPLETION Dot11extPreAssociateCompletion;

DWORD Dot11extPreAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwReasonCode,
  [in]           DWORD dwWin32Error
)
{...}

Parameter

[in, optional] hDot11SvcHandle

Handel yang digunakan oleh sistem operasi 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). Nilai handel ini ditentukan melalui panggilan sebelumnya ke Dot11ExtIhvPerformPreAssociate Fungsi Handler IHV.

[in] dwReasonCode

Nilai yang menyediakan informasi tambahan untuk status penyelesaian operasi pra-asosiasi. DLL Ekstensi IHV harus mengatur dwReasonCode ke nilai L2_REASON_CODE_xxxx, yang ditentukan dalam L2cmn.h.

DLL Ekstensi IHV mengembalikan status penyelesaian umum operasi pra-asosiasi melalui parameter dwWin32Error . Biasanya, DLL Ekstensi IHV mengatur dwReasonCode ke nilai dalam rentang dari L2_REASON_CODE_IHV_BASE hingga (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).

[in] dwWin32Error

Status penyelesaian operasi pra-asosiasi sebagaimana didefinisikan oleh kode kesalahan dalam Winerror.h. Jika operasi berhasil diselesaikan, DLL Ekstensi IHV harus mengatur dwWin32Error ke ERROR_SUCCESS.

Nilai kembali

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

Keterangan

DLL Ekstensi IHV harus mengikuti panduan ini saat memanggil fungsi Dot11ExtPreAssociateCompletion .

  • Jika operasi pra-asosiasi berhasil diselesaikan, DLL Ekstensi IHV harus mengatur dwReasonCode ke salah satu hal berikut:
    • L2_REASON_CODE_SUCCESS.
    • Nilai yang ditentukan IHV dalam rentang dari L2_REASON_CODE_IHV_BASE hingga (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
    Dalam situasi ini, DLL Ekstensi IHV harus mengatur dwWin32Error ke ERROR_SUCCESS.
  • Jika operasi pra-asosiasi selesai dengan kegagalan, DLL Ekstensi IHV tidak boleh mengatur dwReasonCode ke L2_REASON_CODE_SUCCESS. Sebagai gantinya, DLL harus mengatur dwReasonCode ke salah satu hal berikut ini:
    • Nilai kesalahan L2_REASON_CODE_xxxx yang sesuai.
    • Nilai yang ditentukan IHV dalam rentang dari L2_REASON_CODE_IHV_BASE hingga (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
    Dalam situasi ini, DLL Ekstensi IHV tidak boleh mengatur dwWin32Error ke ERROR_SUCCESS. Sebaliknya, DLL harus mengatur dwWin32Error ke kode kesalahan yang sesuai yang ditentukan di Winerror.h
  • DLL Ekstensi IHV harus memanggil Dot11ExtPreAssociateCompletion untuk membatalkan semua operasi pra-asosiasi yang tertunda setiap kali fungsi Dot11ExtIhvAdapterReset atau Dot11ExtIhvDeinitAdapter IHV Handler dipanggil. Dalam situasi ini, DLL harus mengatur parameter dwWin32Error ke ERROR_CANCELLED.

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)

Lihat juga

Dot11ExtIhvAdapterReset

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

Fungsi Handler IHV Asli 802.11

Dot11ExtIhvPerformPreAssociate