DOT11EXTIHV_PERFORM_PRE_ASSOCIATE コールバック関数 (wlanihv.h)
構文
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 を含む) |