次の方法で共有

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

  • [アーティクル]
重要Native 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨です。 代わりに WLAN デバイス ドライバー インターフェイス (WDI) を使用してください。 WDI の詳細については、WLAN ユニバーサル Windows ドライバー モデル を参照してください。
 
IHV 拡張機能 DLL は、dot11ExtPreAssociateCompletion 関数 呼び出して、 の呼び出しによって開始された事前関連付け操作を非同期的に完了します。dot11ExtIhvPerformPreAssociate IHV ハンドラー関数を します。

構文

DOT11EXT_PRE_ASSOCIATE_COMPLETION Dot11extPreAssociateCompletion;

DWORD Dot11extPreAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwReasonCode,
  [in]           DWORD dwWin32Error
)
{...}

パラメーター

[in, optional] hDot11SvcHandle

オペレーティング システムがワイヤレス LAN (WLAN) アダプターを参照するために使用するハンドル。 このハンドル値は、Dot11ExtIhvInitAdapter IHV ハンドラー関数への以前の呼び出しによって指定されました。

[in, optional] hConnectSession

オペレーティング システムが基本サービス セット (BSS) ネットワークとの接続セッションを参照するために使用するハンドル。 このハンドル値は、前の呼び出しで指定されたdot11ExtIhvPerformPreAssociate IHV ハンドラー関数を します。

[in] dwReasonCode

関連付け前操作の完了状態に関する追加情報を提供する値。 IHV 拡張機能 DLL は、dwReasonCode L2cmn.h で定義されているL2_REASON_CODE_xxxx値に設定する必要があります。

IHV 拡張機能 DLL は、dwWin32Error パラメーターを使用して、関連付け前操作の一般的な完了状態を返します。 通常、IHV 拡張機能 DLL は、dwReasonCode を L2_REASON_CODE_IHV_BASE から (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) までの範囲の値に設定します。

[in] dwWin32Error

Winerror.h 内のエラー コードによって定義されている関連付け前操作の完了状態。 操作が正常に完了した場合、IHV 拡張機能 DLL dwWin32Error をERROR_SUCCESSに設定する必要があります。

戻り値

呼び出しが成功した場合、関数はERROR_SUCCESSを返します。 それ以外の場合は、Winerror.h で定義されているエラー コードが返されます。

備考

IHV 拡張機能 DLL は、Dot11ExtPreAssociateCompletion 関数を呼び出すときに、これらのガイドラインに従う必要があります。

  • 関連付け前操作が正常に完了した場合、IHV 拡張機能 DLL dwReasonCode を次のいずれかに設定する必要があります。
    • L2_REASON_CODE_SUCCESS。
    • L2_REASON_CODE_IHV_BASE から (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) までの範囲の IHV 定義値。
    このような状況では、IHV 拡張機能 DLL dwWin32Error をERROR_SUCCESSに設定する必要があります。
  • 関連付け前操作が失敗して完了した場合、IHV 拡張機能 DLL dwReasonCode をL2_REASON_CODE_SUCCESSに設定することはできません。 代わりに、DLL dwReasonCode を次のいずれかに設定する必要があります。
    • 適切なL2_REASON_CODE_xxxxエラー値。
    • L2_REASON_CODE_IHV_BASE から (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) までの範囲の IHV 定義値。
    このような場合、IHV 拡張機能 DLL dwWin32Error をERROR_SUCCESSに設定することはできません。 代わりに、DLL dwWin32Error を Winerror.h で定義された適切なエラー コードに設定する必要があります。
  • IHV 拡張機能 DLL は 、dot11ExtIhvAdapterReset または Dot11ExtIhvDeinitAdapter IHV ハンドラー関数が呼び出されるたびに、すべての保留中の関連付け前操作を取り消すために Dot11ExtPreAssociateCompletion を呼び出す必要があります。 このような場合、DLL は、dwWin32Error パラメーターをERROR_CANCELLEDに設定する必要があります。

必要条件

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

関連項目

Dot11ExtIhvAdapterReset の

Dot11ExtIhvDeinitAdapter の

Dot11ExtIhvInitAdapter の

ネイティブ 802.11 IHV ハンドラー関数

Dot11ExtIhvPerformPreAssociate