DOT11EXTIHV_CREATE_DISCOVERY_PROFILES回呼函式 (wlanihv.h)

發行項
03/01/2024

重要原生 802.11 無線 LAN 介面在 Windows 10 和更新版本中已被取代。請改用 WLAN 設備驅動器介面 (WDI) 。如需 WDI 的詳細資訊，請參閱 WLAN 通用 Windows 驅動程式模型。

操作系統會呼叫 Dot11ExtIhvCreateDiscoveryProfiles 函式，以傳回暫時連線和安全性配置檔片段，這些片段可用來連線到基本服務集 (BSS) 網路，而該網路配置檔不存在。

語法

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
)
{...}

參數

[in, optional] hIhvExtAdapter

IHV 延伸模組 DLL 用來參考無線 LAN (WLAN) 配接器的句柄。這個句柄值是透過先前呼叫 Dot11ExtIhvInitAdapter IHV Handler 函式來指定。

[in] bInsecure

布爾值，指定探索配置檔的安全性狀態。如果設定為 TRUE，IHV 延伸模組 DLL 只能傳回安全配置檔，例如涉及使用者驗證的配置檔。

[in, optional] pIhvProfileParams

的指標 DOT11EXT_IHV_PROFILE_PARAMS 結構。此結構會定義將套用配置檔延伸模組之基本服務集的屬性 (BSS) 網路。

[in, optional] pConnectableBssid

DOT11_BSS_LIST 結構的指標，其中包含從 BSS 網路接收的一或多個 802.11 指標或探查回應框架。此清單衍生自WLAN 配接器執行的最後一次掃描作業結果。如需掃描作業的詳細資訊，請參閱原生 802.11 掃描作業。

注意針對 Windows Vista，IHV 延伸模組 DLL 僅支援基礎結構基本服務集 (BSS) 網路。

[out] pIhvDiscoveryProfileList

的指標 DOT11EXT_IHV_DISCOVERY_PROFILE_LIST 結構，指定 IHV 探索設定檔的清單。

[out] pdwReasonCode

DWORD 值的指標，提供 Dot11ExtIhvCreateDiscoveryProfiles 函式傳回值的其他資訊。 IHV Extensions DLL 必須將 * pdwReasonCode 設定為 L2_REASON_CODE_xxxx 值，這些值定義於 L2cmn.h 中。

傳回值

如果呼叫成功，函式會傳回ERROR_SUCCESS。否則，它會傳回 Winerror.h 中定義的錯誤碼。

備註

WLAN 配接器完成掃描作業之後，操作系統可能會呼叫 Dot11ExtIhvCreateDiscoveryProfiles 來建立暫時配置檔片段，以用來連線到使用者尚未建立網路配置檔的 BSS 網路。

當 呼叫 Dot11ExtIhvCreateDiscoveryProfiles 時，IHV 延伸模組 DLL 必須遵循這些指導方針。

如果 IHV 延伸模組 DLL 可以傳回可用來連線到 BSS 網路的配置檔片段， Dot11ExtIhvCreateDiscoveryProfiles 函式必須傳回ERROR_SUCCESS。否則，函式必須從 Winerror.h 中定義的ERROR_xxxx值傳回適當的錯誤碼。
IHV 延伸模組 DLL 提供有關 Dot11ExtIhvCreateDiscoveryProfiles 函式傳回結果的詳細資訊。 DLL 必須將 * pdwReasonCode 設定為下列其中一項：
- L2_REASON_CODE_SUCCESS，如果可以傳回 BSS 網路清單的設定檔片段。
- 如果無法針對 BSS 網路清單傳回設定檔片段，則為適當的L2_REASON_CODE_xxxx錯誤值。
- 從 L2_REASON_CODE_IHV_BASE 到 (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) 範圍中的 IHV 定義值，不論是否傳回配置檔片段。

如需建立探索配置檔的詳細資訊，請參閱建立網路配置檔延伸模組。

規格需求

需求	值
最低支援的用戶端	可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台	桌面
標頭	wlanihv.h (包括 Wlanihv.h、Winclient.h、L2cmn.h)