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

[アーティクル]
05/23/2024

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

IHV 拡張機能 DLL は Dot11ExtStartOneX 関数を呼び出して、アクセスポイント (AP) で 802.1X 認証操作を開始します。この状況では、認証は IHV 拡張機能 DLL ではなく、ネイティブ 802.11 フレームワークの 802.1X モジュールによって管理されます。

構文

DOT11EXT_ONEX_START Dot11extOnexStart;

DWORD Dot11extOnexStart(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] EAP_ATTRIBUTES *pEapAttributes
)
{...}

パラメーター

[in, optional] hDot11SvcHandle

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

[in, optional] pEapAttributes

認証セッションによって返される EAP 属性を含むEAP_ATTRIBUTES配列構造体へのポインター。 EAP_ATTRIBUTESの詳細については、Microsoft Windows SDKのドキュメントを参照してください。

戻り値

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

注釈

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

IHV 拡張機能 DLL は 、Dot11ExtStartOneX 関数を呼び出すことによって 802.1X 認証操作を開始します。 Dot11ExtStartOneX は、関連付け後の操作中または操作の完了後にのみ呼び出すことができます。この操作の詳細については、「関連付け後の操作」を参照してください。

Dot11ExtStartOneX 関数が呼び出されると、オペレーティングシステムは EAP over LAN (EAPOL) Start パケットを AP に送信します。 EAPOL-Start パケットが 3 回送信された後に AP が応答しない場合、オペレーティングシステムは 802.1X 認証操作に失敗し、 Dot11ExtIhvOneXIndicateResult IHV ハンドラー関数。 EAPOL-Start パケットの詳細については、IEEE 802.1X-1999 標準の第 7.5 項および第 8.4.2 項を参照してください。

802.1X 認証操作が開始された後、IHV 拡張機能 DLL は次のガイドラインに従う必要があります。

IHV 拡張機能では、すべての EAPOL パケットをオペレーティングシステムに転送して処理する必要があります。 DLL が Dot11ExtIhvReceivePacket IHV ハンドラー関数の呼び出しを介して EAPOL パケットを受信する場合、DLL は Dot11ExtProcessOneXPacket を呼び出して、パケットをオペレーティングシステムに転送する必要があります。
EAPOL パケットの詳細については、IEEE 802.1X-2001 標準の第 7 条を参照してください。

メモ IHV 拡張機能 DLL は、EAPOL-Key パケットの処理を担当し、オペレーティングシステムに転送することはできません。
802.1X 認証操作が完了すると、オペレーティングシステムは、 Dot11ExtIhvOneXIndicateResult 承認が進行中であることを示す IHV ハンドラー関数。
IHV 拡張機能 DLL は、 Dot11ExtStopOneX を呼び出すことによって、802.1X 認証操作を取り消すことができます。

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

要件

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