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

[アーティクル]
02/07/2025

重要Native 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨です。代わりに WLAN デバイスドライバーインターフェイス (WDI) を使用してください。 WDI の詳細については、WLAN ユニバーサル Windows ドライバーモデルを参照してください。

IHV 拡張機能 DLL は、Dot11ExtProcessOneXPacket 関数を呼び出して、アクセスポイント (AP) による 802.1X 認証操作中に処理するために、EAP over LAN (EAPOL) パケットをオペレーティングシステムに転送します。

構文

DOT11EXT_PROCESS_ONEX_PACKET Dot11extProcessOnexPacket;

DWORD Dot11extProcessOnexPacket(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           DWORD dwInPacketSize,
  [in]           LPVOID pvInPacket
)
{...}

パラメーター

[in, optional] hDot11SvcHandle

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

[in] dwInPacketSize

pvInPacket パラメーターによって参照されるバッファー内のパケットデータの長さ (バイト単位)。

[in] pvInPacket

AP から受信した EAPOL パケット。 pvInPacket パラメーターは、EAPOL プロトコルデータユニット (PDU) のパケットの種類フィールドから開始する EAPOL パケットを参照する必要があります。 EAPOL パケットタイプフィールドの詳細については、IEEE 802.1X-2001 標準の第 7.5.4 項を参照してください。

戻り値

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

備考

Dot11ExtStartOneX 関数を呼び出すと、IHV 拡張機能 DLL は、ネイティブ 802.11 フレームワークの 802.1X モジュールを使用して 802.1X 認証操作を開始します。これにより、DLL はオペレーティングシステムでサポートされている標準の拡張認証プロトコル (EAP) アルゴリズムを使用できます。

802.1X 認証操作が保留中の間、IHV 拡張機能 DLL は、Dot11ExtProcessOneXPacket 関数の呼び出しを通じて、受信した EAP over LAN (EAPOL) パケットをオペレーティングシステムに転送します。 IHV 拡張機能 DLL は、Dot11ExtIhvReceivePacket IHV ハンドラー関数を介してこれらのパケットを受信します。

注 IHV 拡張機能 DLL は、EAPOL-Key パケットの処理を担当し、オペレーティングシステムに転送しないでください。

EAPOL パケットの詳細については、IEEE 802.1X-2001 標準の第 7 項を参照してください。

認証に 802.1X モジュールを使用する方法の詳細については、「Interface to the Native 802.11 802.1X Module

必要条件

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

次の方法で共有

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

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース