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

  • [アーティクル]
大事なネイティブ 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 認証操作を開始します。 これにより、オペレーティング システムでサポートされている標準の拡張認証プロトコル (EAP) アルゴリズムを DLL で使用できます。

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

メモ IHV 拡張機能 DLL は、EAPOL-Key パケットの処理を担当し、オペレーティング システムに転送することはできません。
 
EAPOL パケットの詳細については、IEEE 802.1X-2001 標準の第 7 条を参照してください。

認証に 802.1X モジュールを使用する方法の詳細については、「Native 802.11 802.1X モジュールへのインターフェイス」を参照してください。

要件

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

こちらもご覧ください

Dot11ExtIhvReceivePacket

Dot11ExtIhvInitAdapter

Dot11ExtIhvOneXIndicateResult

Dot11ExtStartOneX

Dot11ExtStopOneX