DOT11EXTIHV_CREATE_DISCOVERY_PROFILES fungsi panggilan balik (wlanihv.h)

Artikel
03/01/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 Dot11ExtIhvCreateDiscoveryProfiles untuk mengembalikan konektivitas sementara dan fragmen profil keamanan yang dapat digunakan untuk menyambungkan ke jaringan set layanan dasar (BSS) yang profil jaringannya tidak ada.

Sintaks

DOT11EXTIHV_CREATE_DISCOVERY_PROFILES Dot11extihvCreateDiscoveryProfiles;

DWORD Dot11extihvCreateDiscoveryProfiles(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           BOOL bInsecure,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in, optional] PDOT11_BSS_LIST pConnectableBssid,
  [out]          PDOT11EXT_IHV_DISCOVERY_PROFILE_LIST pIhvDiscoveryProfileList,
  [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 Handler IHV Dot11ExtIhvInitAdapter .

[in] bInsecure

Nilai Boolean yang menentukan status keamanan profil penemuan. Jika diatur ke TRUE, DLL Ekstensi IHV hanya dapat mengembalikan profil aman, seperti profil yang melibatkan autentikasi pengguna.

[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, optional] pConnectableBssid

Penunjuk ke struktur DOT11_BSS_LIST , yang berisi satu atau beberapa bingkai Beacon atau Probe Response 802.11 yang diterima dari jaringan BSS. Daftar ini berasal dari hasil operasi pemindaian terakhir yang dilakukan oleh adaptor WLAN. Untuk informasi selengkapnya tentang operasi pemindaian, lihat Operasi Pemindaian Native 802.11.

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

[out] pIhvDiscoveryProfileList

Penunjuk ke DOT11EXT_IHV_DISCOVERY_PROFILE_LIST struktur yang menentukan daftar profil penemuan IHV.

[out] pdwReasonCode

Penunjuk ke nilai DWORD, yang menyediakan informasi tambahan untuk nilai pengembalian fungsi Dot11ExtIhvCreateDiscoveryProfiles . 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

Setelah adaptor WLAN menyelesaikan operasi pemindaian, sistem operasi mungkin memanggil Dot11ExtIhvCreateDiscoveryProfiles untuk membuat fragmen profil sementara yang dapat digunakan untuk menyambungkan ke jaringan BSS yang profil jaringannya belum dibuat oleh pengguna.

Ketika Dot11ExtIhvCreateDiscoveryProfiles dipanggil, DLL Ekstensi IHV harus mengikuti panduan ini.

Jika DLL Ekstensi IHV dapat mengembalikan fragmen profil yang dapat digunakan untuk menyambungkan ke jaringan BSS, fungsi Dot11ExtIhvCreateDiscoveryProfiles 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 pengembalian fungsi Dot11ExtIhvCreateDiscoveryProfiles . DLL harus mengatur * pdwReasonCode ke salah satu hal berikut:
- L2_REASON_CODE_SUCCESS, jika fragmen profil dapat dikembalikan untuk daftar jaringan BSS.
- Nilai kesalahan L2_REASON_CODE_xxxx yang sesuai, jika fragmen profil tidak dapat dikembalikan untuk daftar jaringan BSS.
- 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 fragmen profil dikembalikan.

Untuk informasi selengkapnya tentang membuat profil penemuan, lihat Membuat Ekstensi Profil Jaringan.

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, Winclient.h, L2cmn.h)