共用方式為

DOT11EXTIHV_PERFORM_CAPABILITY_MATCH回呼函式 (wlanihv.h)

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

操作系統會呼叫 Dot11ExtIhvPerformCapabilityMatch 函式，要求 IHV 延伸模組 DLL 判斷偵測到的基本服務集 (BSS) 網路是否符合 IHV 所定義的連線和安全性配置檔延伸模組。

語法

DOT11EXTIHV_PERFORM_CAPABILITY_MATCH Dot11extihvPerformCapabilityMatch;

DWORD Dot11extihvPerformCapabilityMatch(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [in, optional] PDOT11_BSS_LIST pConnectableBssid,
  [out]          PDWORD pdwReasonCode
)
{...}

參數

[in, optional] hIhvExtAdapter

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

[in, optional] pIhvProfileParams

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

[in] pIhvConnProfile

的指標 DOT11EXT_IHV_CONNECTIVITY_PROFILE 結構，其中包含IHV配置檔的連線設定。

[in] pIhvSecProfile

的指標 DOT11EXT_IHV_SECURITY_PROFILE 結構，其中包含IHV配置檔的安全性設定。

[in, optional] pConnectableBssid

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

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

[out] pdwReasonCode

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

傳回值

如果 802.11 指標和探查回應框架清單中的所有專案都支援配置檔片段中定義的連線和安全性屬性，則函式會傳回ERROR_SUCCESS。 否則，它會傳回 Winerror.h 中定義的錯誤碼。

備註

在WLAN 配接器完成掃描作業以偵測範圍內 BSS 網路之後，操作系統可能會呼叫 Dot11ExtIhvPerformCapabilityMatch 函式，以判斷任何偵測到的 BSS 網路是否符合 IHV 所定義的連線能力或安全性配置檔延伸模組。

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

  • 如果 IHV 延伸模組 DLL 找到至少一個符合配置檔片段的 IEEE 802.11 指標或探查回應框架，則必須將 * pdwReasonCode 設定為下列其中一項：
    • L2_REASON_CODE_SUCCESS。
    • 範圍中的 IHV 定義值，範圍從 L2_REASON_CODE_IHV_BASE 到 (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) 。
    在此情況下， Dot11ExtIhvPerformCapabilityMatch 函式必須傳回ERROR_SUCCESS。
  • 如果 IHV 延伸模組 DLL 找不到符合配置檔片段的 IEEE 802.11 指標或探查回應框架，則不得將 *pdwReasonCode 設定為 L2_REASON_CODE_SUCCESS。 相反地，DLL 必須將 * pdwReasonCode 設定為下列其中一項：
    • 適當的L2_REASON_CODE_xxxx錯誤值。
    • 範圍中的 IHV 定義值，範圍從 L2_REASON_CODE_IHV_BASE 到 (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) 。
    在此情況下， Dot11ExtIhvPerformCapabilityMatch 函式不得傳回ERROR_SUCCESS。
如需 Native 802.11 XML 架構的詳細資訊，請參閱 Microsoft Windows SDK 檔。

規格需求

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

另請參閱

DOT11EXT_IHV_CONNECTIVITY_PROFILE

DOT11EXT_IHV_SECURITY_PROFILE

DOT11_BSS_LIST

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_PROFILE_PARAMS