重要Native 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨です。 代わりに WLAN デバイス ドライバー インターフェイス (WDI) を使用してください。 WDI の詳細については、WLAN ユニバーサル Windows ドライバー モデル を参照してください。
構文
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
Dot11ExtIhvPerformPreAssociate 関数の戻り値に関する追加情報を提供する DWORD 値へのポインター。 IHV 拡張機能 DLL では、* pdwReasonCode を L2cmn.h で定義されているL2_REASON_CODE_xxxx値に設定する必要があります。
戻り値
IHV 拡張 DLL が事前関連付け操作を開始できる場合は、操作を非同期的に完了する必要があります。 この状況では、関数はERROR_SUCCESSを返します。
IHV 拡張機能 DLL が事前関連付け操作を開始できない場合は、winerror.h で定義されているエラー コード返します。
備考
オペレーティング システムは、Dot11ExtIhvPerformPreAssociate 関数を呼び出して、IHV 拡張機能 DLL との事前関連付け操作を開始します。 オペレーティング システムは、WLAN アダプターを介して基本サービス セット (BSS) ネットワークとの接続操作を開始する前に、この操作を開始します。 接続操作の詳細については、「接続操作の」を参照してください。
関連付け前操作は、Dot11ExtIhvPerformPreAssociate 呼び出しから非同期的に完了する必要があります。 関連付け前の操作が完了したら、IHV 拡張機能 DLL が呼び出す必要があります。dot11ExtPreAssociateCompletion をします。
Dot11ExtIhvPerformPreAssociate 関数が呼び出されると、IHV Extensions DLL は次のガイドラインに従う必要があります。
- IHV 拡張機能 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 オペレーティング システムで使用できます。 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | wlanihv.h (Wlanihv.h、L2cmn.h を含む) |
関連項目
DOT11EXT_IHV_CONNECTIVITY_PROFILEDot11ExtIhvInitAdapter の
Dot11ExtPreAssociateCompletion の