次の方法で共有

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

  • [アーティクル]
大事なネイティブ 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 オペレーティング システムで使用できます。
対象プラットフォーム デスクトップ
Header wlanihv.h (Wlanihv.h を含む)

こちらもご覧ください

Dot11ExtIhvAdapterReset

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

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

Dot11ExtIhvPerformPreAssociate