DOT11EXTIHV_PERFORM_CAPABILITY_MATCH コールバック関数 (wlanihv.h)

オペレーティング システムは Dot11ExtIhvPerformCapabilityMatch 関数を呼び出して、検出された基本サービス セット (BSS) ネットワークが IHV によって定義された接続とセキュリティ プロファイル拡張機能と一致するかどうかを IHV 拡張機能 DLL が判断するように要求します。

構文

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

ワイヤレス LAN (WLAN) アダプターを参照するために IHV 拡張機能 DLL によって使用されるハンドル。 このハンドル値は、 Dot11ExtIhvInitAdapter IHV ハンドラー関数の以前の呼び出しによって指定されました。

[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

BSS ネットワークから受信した 1 つ以上の 802.11 ビーコンまたはプローブ応答フレームを含む、 DOT11_BSS_LIST構造体への ポインター。 この一覧は、WLAN アダプターによって最後に実行されたスキャン操作の結果から派生します。 スキャン操作の詳細については、「 Native 802.11 Scan Operations」を参照してください。

[out] pdwReasonCode

Dot11ExtIhvPerformCapabilityMatch 関数の戻り値に関する追加情報を提供する DWORD 値へのポインター。 IHV 拡張機能 DLL では、 * pdwReasonCode を L2cmn.h で定義されているL2_REASON_CODE_xxxx値に設定する必要があります。

戻り値

802.11 ビーコン フレームとプローブ応答フレームの一覧のすべてのエントリで、プロファイル フラグメントで定義されている接続属性とセキュリティ属性がサポートされている場合、関数はERROR_SUCCESSを返します。 それ以外の場合は、Winerror.h で定義されたエラー コードが返されます。

注釈

WLAN アダプターが範囲内の BSS ネットワークを検出するためのスキャン操作を完了した後、オペレーティング システムは Dot11ExtIhvPerformCapabilityMatch 関数を呼び出して、検出された BSS ネットワークのいずれかが IHV によって定義された接続またはセキュリティ プロファイル拡張機能と一致するかどうかを判断する場合があります。

Dot11ExtIhvPerformCapabilityMatch 関数が呼び出されると、IHV 拡張機能 DLL は次のガイドラインに従う必要があります。

• IHV 拡張機能 DLL が、プロファイル フラグメントに一致する少なくとも 1 つの IEEE 802.11 ビーコンまたはプローブ応答フレームを検出する場合は、* pdwReasonCode を次のいずれかに設定する必要があります。
  • L2_REASON_CODE_SUCCESS。
  • L2_REASON_CODE_IHV_BASE から (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) までの範囲の IHV 定義値。
  このような場合、 Dot11ExtIhvPerformCapabilityMatch 関数はERROR_SUCCESSを返す必要があります。
• IHV 拡張機能 DLL で、プロファイル フラグメントに一致する IEEE 802.11 ビーコンまたはプローブ応答フレームが見つからない場合は、 *pdwReasonCode を L2_REASON_CODE_SUCCESSに設定しないでください。 代わりに、DLL で * pdwReasonCode を次のいずれかに設定する必要があります。
  • 適切なL2_REASON_CODE_xxxxエラー値。
  • L2_REASON_CODE_IHV_BASE から (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) までの範囲の IHV 定義値。
  このような場合、 Dot11ExtIhvPerformCapabilityMatch 関数はERROR_SUCCESSを返す必要があります。

要件

こちらもご覧ください

DOT11EXT_IHV_SECURITY_PROFILE

DOT11_BSS_LIST

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_PROFILE_PARAMS