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

[アーティクル]
02/27/2024

大事なネイティブ 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨となりました。代わりに WLAN デバイスドライバーインターフェイス (WDI) を使用してください。 WDI の詳細については、「 WLAN ユニバーサル Windows ドライバーモデル」を参照してください。

IHV 拡張機能 DLL は Dot11ExtPostAssociateCompletion 関数を呼び出して、の呼び出しによって開始された関連付け後操作を非同期的に完了します。 Dot11ExtIhvPerformPostAssociate IHV ハンドラー関数。

構文

DOT11EXT_POST_ASSOCIATE_COMPLETION Dot11extPostAssociateCompletion;

DWORD Dot11extPostAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hSecuritySessionID,
  [in, optional] PDOT11_MAC_ADDRESS pPeer,
  [in]           DWORD dwReasonCode,
  [in]           DWORD dwWin32Error
)
{...}

パラメーター

[in, optional] hDot11SvcHandle

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

[in, optional] hSecuritySessionID

に対する以前の呼び出しによって返されたセキュリティセッション識別子 (ID) のハンドル Dot11ExtIhvPerformPostAssociate IHV ハンドラー関数。

[in, optional] pPeer

IHV 拡張機能 DLL がセキュリティ操作を実行したアクセスポイント (AP) のメディアアクセス制御 (MAC) アドレス。このパラメーターは、 DOT11_MAC_ADDRESS 構造体として書式設定されます。

メモ Windows Vista の場合、IHV 拡張機能 DLL では、インフラストラクチャの基本サービスセット (BSS) ネットワークのみがサポートされます。

[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 は 、Dot11ExtPostAssociateCompletion 関数を呼び出して、次のいずれかを実行します。

への呼び出しによって開始された関連付け後操作を完了します。 Dot11ExtIhvPerformPostAssociate IHV ハンドラー関数。
関連付け後の操作が完了したら、 hSecuritySessionID パラメーターによって参照されるセキュリティセッションのポート状態の変更を示します。
たとえば、ポートの承認状態が変更された場合、IHV 拡張機能 DLL は Dot11ExtPostAssociateCompletion を呼び出すことによってオペレーティングシステムに通知できます。

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

関連付け後の操作が正常に完了した場合、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 によって dwWin32Error がERROR_SUCCESSに設定されている場合、オペレーティングシステムでは、セキュリティセッションのポート状態が承認された状態であると見なされます。ポートが承認された状態になると、オペレーティングシステムでは、WLAN アダプターを介してすべてのデータパケットを送信できます。
関連付け後の操作が失敗して完了した場合、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 で dwWin32Error が ERROR_SUCCESS に設定されていない場合、オペレーティングシステムは、セキュリティセッションのポート状態が未承認の状態であると見なします。ポートが未承認の状態になると、オペレーティングシステムでは、 Dot11ExtSendPacket IHV Extensions 関数を介して送信されたパケットを含むセキュリティパケットを WLAN アダプター経由で送信できます。
IHV 拡張機能 DLL では、Dot11ExtIhvAdapterReset 関数または Dot11ExtIhvDeinitAdapter IHV ハンドラー関数が呼び出されるたびに、関連付け後のすべての保留中の操作を取り消すには、Dot11ExtPostAssociateCompletion を呼び出す必要があります。この場合、DLL は dwStatus パラメーターを ERROR_CANCELLED に設定する必要があります。

要件

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