DOT11EXT_POST_ASSOCIATE_COMPLETION 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.

DLL Ekstensi IHV memanggil fungsi Dot11ExtPostAssociateCompletion untuk menyelesaikan operasi pasca-asosiasi secara asinkron yang dimulai melalui panggilan ke Dot11ExtIhvPerformPostAssociate Fungsi Handler IHV.

Sintaks

DOT11EXT_POST_ASSOCIATE_COMPLETION Dot11extPostAssociateCompletion;

DWORD Dot11extPostAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hSecuritySessionID,
  [in, optional] PDOT11_MAC_ADDRESS pPeer,
  [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 Handler IHV Dot11ExtIhvInitAdapter .

[in, optional] hSecuritySessionID

Handel pengidentifikasi sesi keamanan (ID) yang dikembalikan melalui panggilan sebelumnya ke Dot11ExtIhvPerformPostAssociate Fungsi Handler IHV.

[in, optional] pPeer

Alamat kontrol akses media (MAC) dari titik akses (AP) tempat DLL Ekstensi IHV melakukan operasi keamanan. Parameter ini diformat sebagai struktur DOT11_MAC_ADDRESS .

Catatan Untuk Windows Vista, DLL Ekstensi IHV hanya mendukung jaringan set layanan dasar infrastruktur (BSS).

[in] dwReasonCode

Nilai yang memberikan informasi tambahan untuk status penyelesaian operasi pasca-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 pasca-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 pasca-asosiasi sebagaimana didefinisikan oleh kode kesalahan dalam Winerror.h. Jika operasi berhasil diselesaikan, DLL Ekstensi IHV harus mengatur dwWin32Error ke ERROR_SUCCESS.

Mengembalikan nilai

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

Keterangan

DLL Ekstensi IHV memanggil fungsi Dot11ExtPostAssociateCompletion untuk melakukan salah satu hal berikut:

Menyelesaikan operasi pasca-asosiasi yang dimulai dengan panggilan ke Dot11ExtIhvPerformPostAssociate Fungsi Handler IHV.
Setelah menyelesaikan operasi pasca-asosiasi, tunjukkan perubahan status port untuk sesi keamanan yang direferensikan oleh parameter hSecuritySessionID .
Misalnya, jika status otorisasi port berubah, DLL Ekstensi IHV dapat memberi tahu sistem operasi dengan memanggil Dot11ExtPostAssociateCompletion.

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

Jika operasi pasca-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.
Catatan Jika DLL Ekstensi IHV mengatur dwWin32Error ke ERROR_SUCCESS, sistem operasi akan mengasumsikan bahwa status port untuk sesi keamanan dalam status resmi. Setelah port dalam status resmi, sistem operasi memungkinkan semua paket data dikirim melalui adaptor WLAN.
Jika operasi pasca-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 dalam Winerror.h.
Catatan Jika DLL Ekstensi IHV tidak mengatur dwWin32Error ke ERROR_SUCCESS, sistem operasi akan menganggap status port untuk sesi keamanan dalam keadaan tidak sah. Setelah port dalam keadaan tidak sah, sistem operasi memungkinkan paket keamanan, termasuk paket yang dikirim melalui fungsi Ekstensi IHV Dot11ExtSendPacket , untuk dikirim melalui adaptor WLAN.
DLL Ekstensi IHV harus memanggil Dot11ExtPostAssociateCompletion untuk membatalkan semua operasi pasca-asosiasi yang tertunda setiap kali fungsi Dot11ExtIhvAdapterReset atau Dot11ExtIhvDeinitAdapter IHV Handler dipanggil. Dalam situasi ini, DLL harus mengatur parameter dwStatus 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)