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

構文

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 に設定する必要があります。

要件

こちらもご覧ください

Dot11ExtIhvAdapterReset

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

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