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

[アーティクル]
08/08/2023

大事なネイティブ 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨となりました。代わりに WLAN デバイスドライバーインターフェイス (WDI) を使用してください。 WDI の詳細については、「 WLAN ユニバーサル Windows ドライバーモデル」を参照してください。

オペレーティングシステムは Dot11ExtIhvPerformPreAssociate 関数を呼び出して、IHV 拡張機能 DLL が基本サービスセット (BSS) ネットワークとの事前関連付け操作を開始するように要求します。

構文

DOT11EXTIHV_PERFORM_PRE_ASSOCIATE Dot11extihvPerformPreAssociate;

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

パラメーター

[in, optional] hIhvExtAdapter

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

[in, optional] hConnectSession

基本サービスセット (BSS) ネットワークとの接続セッションを参照するためにオペレーティングシステムによって使用されるハンドル。

[in, optional] pIhvProfileParams

へのポインター DOT11EXT_IHV_PROFILE_PARAMS 構造体。この構造体は、プロファイル拡張機能を適用する基本サービスセット (BSS) ネットワークの属性を定義します。

[in] pIhvConnProfile

へのポインター DOT11EXT_IHV_CONNECTIVITY_PROFILE IHV プロファイルの接続設定を含む構造体です。

[in] pIhvSecProfile

へのポインター DOT11EXT_IHV_SECURITY_PROFILE IHV プロファイルのセキュリティ設定を指定する構造体です。

[in] pConnectableBssid

DLL が事前関連付け操作を実行する BSS ネットワークのサービスセット識別子 (SSID) の 1 つ以上の 802.11 ビーコンまたはプローブ応答フレームを含む、 DOT11_BSS_LIST 構造体へのポインター。

[out] pdwReasonCode

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

戻り値

IHV 拡張 DLL が事前関連付け操作を開始できる場合は、操作を非同期的に完了する必要があります。この場合、関数は ERROR_SUCCESS を返します。

IHV Extensions DLL で事前関連付け操作を開始できない場合は、 Winerror.h で定義されているエラーコードが返されます。

注釈

オペレーティングシステムは Dot11ExtIhvPerformPreAssociate 関数を呼び出して、IHV Extensions DLL との事前関連付け操作を開始します。オペレーティングシステムは、WLAN アダプターを介して基本サービスセット (BSS) ネットワークとの接続操作を開始する前に、この操作を開始します。接続操作の詳細については、「接続操作」を参照してください。

関連付け前操作は、 Dot11ExtIhvPerformPreAssociate の呼び出しから非同期的に完了する必要があります。関連付け前操作が完了したら、IHV 拡張機能 DLL はを呼び出す必要があります Dot11ExtPreAssociateCompletion。

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

IHV Extensions DLL が事前関連付け操作を開始できる場合、 Dot11ExtIhvPerformPreAssociate 関数はERROR_SUCCESSを返し、非同期的に操作を完了する必要があります。
IHV 拡張機能 DLL では、 pdwReasonCode パラメーターを使用した事前関連付け操作の開始に関する詳細情報が提供されます。 DLL では、 * pdwReasonCode を次のいずれかに設定する必要があります。
- 関連付け前操作が正常に開始できる場合は、L2_REASON_CODE_SUCCESSします。
- 関連付け前操作を開始できなかった場合は、適切なL2_REASON_CODE_xxxxエラー値。
- 関連付け前操作を開始できるかどうかに関係なく、L2_REASON_CODE_IHV_BASE から (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) までの範囲の IHV 定義値。

関連付け前操作の詳細については、「関連付け前操作」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	デスクトップ
Header	wlanihv.h (Wlanihv.h、L2cmn.h を含む)