次の方法で共有


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

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

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

Dot11ExtStartOneX 関数が呼び出されると、オペレーティング システムは EAP over LAN (EAPOL) 開始パケットを 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 Moduleへのインターフェイス」を参照してください。

必要条件

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

関連項目

dot11ExtPostAssociateCompletion

dot11ExtIhvReceivePacket

Dot11ExtProcessOneXPacket

Dot11ExtIhvInitAdapter

Dot11ExtIhvOneXIndicateResult Dot11ExtIhvPerformPostAssociate

Dot11ExtStopOneX