DOT11EXT_ONEX_START fungsi panggilan balik (wlanihv.h)

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 Dot11ExtStartOneX untuk memulai operasi autentikasi 802.1X dengan titik akses (AP). Dalam situasi ini, autentikasi dikelola oleh modul 802.1X dari kerangka kerja Native 802.11 alih-alih oleh DLL Ekstensi IHV.

Sintaks

DOT11EXT_ONEX_START Dot11extOnexStart;

DWORD Dot11extOnexStart(
  [in, optional] HANDLE hDot11SvcHandle,
                 EAP_ATTRIBUTES *pEapAttributes
)
{...}

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 .

pEapAttributes

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 dapat memulai operasi autentikasi 802.1X dengan menggunakan modul 802.1X dari kerangka kerja Native 802.11. Ini memungkinkan DLL untuk menggunakan algoritma protokol autentikasi yang dapat diperluas standar (EAP) yang didukung oleh sistem operasi.

DLL Ekstensi IHV memulai operasi autentikasi 802.1X dengan memanggil fungsi Dot11ExtStartOneX . Dot11ExtStartOneX hanya dapat dipanggil baik selama operasi pasca-asosiasi atau setelah operasi selesai. Untuk informasi selengkapnya tentang operasi ini, lihat Operasi Pasca-Asosiasi.

Ketika fungsi Dot11ExtStartOneX dipanggil, sistem operasi mengirim paket Mulai EAP melalui LAN (EAPOL) ke AP. Jika AP gagal merespons setelah tiga transmisi paket EAPOL-Start, sistem operasi gagal dalam operasi autentikasi 802.1X dan memanggil Dot11ExtIhvOneXIndicateResult Fungsi Handler IHV. Untuk informasi selengkapnya tentang paket EAPOL-Start, lihat Klausul 7.5 dan Klausul 8.4.2 dari standar IEEE 802.1X-1999.

Setelah operasi autentikasi 802.1X dimulai, DLL Ekstensi IHV harus mengikuti panduan ini.

  • Ekstensi IHV harus meneruskan semua paket EAPOL ke sistem operasi untuk diproses. Ketika DLL menerima paket EAPOL melalui panggilan ke fungsi Dot11ExtIhvReceivePacket IHV Handler, DLL harus memanggil Dot11ExtProcessOneXPacket untuk meneruskan paket ke sistem operasi.

    Untuk informasi selengkapnya tentang paket EAPOL, lihat Klausul 7 standar IEEE 802.1X-2001.

    Catatan DLL Ekstensi IHV bertanggung jawab untuk memproses paket EAPOL-Key dan tidak boleh meneruskan ini ke sistem operasi.
     
  • Ketika operasi autentikasi 802.1X selesai, sistem operasi memanggil Dot11ExtIhvOneXIndicateResult Fungsi Handler IHV untuk menunjukkan bahwa otorisasi sedang berlangsung.
  • DLL Ekstensi IHV dapat membatalkan operasi autentikasi 802.1X dengan memanggil Dot11ExtStopOneX.
Untuk informasi selengkapnya tentang menggunakan modul 802.1X untuk autentikasi, lihat Antarmuka ke Modul Asli 802.11 802.1X.

Persyaratan

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

Lihat juga

Dot11ExtPostAssociateCompletion

Dot11ExtIhvReceivePacket

Dot11ExtProcessOneXPacket

Dot11ExtIhvInitAdapter

Dot11ExtIhvOneXIndicateResult Dot11ExtIhvPerformPostAssociate

Dot11ExtStopOneX