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

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

 

オペレーティング システムは Dot11ExtIhvPerformPostAssociate 関数を呼び出して、IHV 拡張機能 DLL が基本サービス セット (BSS) ネットワークとの関連付け後操作を開始するように要求します。

構文

DOT11EXTIHV_PERFORM_POST_ASSOCIATE Dot11extihvPerformPostAssociate;

DWORD Dot11extihvPerformPostAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] HANDLE hSecuritySessionID,
  [in]           PDOT11_PORT_STATE pPortState,
  [in]           ULONG uDot11AssocParamsBytes,
  [in]           PDOT11_ASSOCIATION_COMPLETION_PARAMETERS pDot11AssocParams
)
{...}

パラメーター

[in, optional] hIhvExtAdapter

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

[in, optional] hSecuritySessionID

セキュリティ セッションのハンドル。 IHV 拡張機能 DLL は、 を呼び出すときにこのハンドル値を使用する必要があります Dot11ExtPostAssociateCompletion を使用して、関連付け後の操作を非同期的に完了します。

[in] pPortState

セキュリティ セッションの現在のポート状態を指定する、 DOT11_PORT_STATE 構造体へのポインター。

[in] uDot11AssocParamsBytes

pDot11AssocParams パラメーターを介して参照されるデータの長さ (バイト単位)。

[in] pDot11AssocParams

へのポインター DOT11_ASSOCIATION_COMPLETION_PARAMETERS 構造体。WLAN アダプターによって完了した関連付け操作の結果を指定します。 WLAN アダプターを管理するネイティブ 802.11 ミニポート ドライバーには、メディア固有の場合にDOT11_ASSOCIATION_COMPLETION_PARAMETERS構造が含まれます NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION 表示。

関連付け操作の詳細については、「 関連付け操作」を参照してください。

戻り値

IHV 拡張 DLL が関連付け後操作を開始できる場合は、操作を非同期的に完了する必要があります。 この場合、関数は ERROR_SUCCESS を返します。

IHV Extensions DLL が関連付け後操作を開始できない場合は、 Winerror.h で定義されているエラー コードが返されます。

注釈

オペレーティング システムは Dot11ExtIhvPerformPostAssociate 関数を呼び出して、IHV Extensions DLL との関連付け後操作を開始します。 オペレーティング システムは、WLAN アダプターがインフラストラクチャ基本サービス セット (BSS) ネットワーク内のアクセス ポイント (AP) との関連付け操作を完了した後に、この操作を開始します。

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

 

関連付け操作の詳細については、「 関連付け操作」を参照してください。

関連付け後の操作は、 Dot11ExtIhvPerformPostAssociate の呼び出しから非同期的に完了する必要があります。 関連付け後の操作が完了したら、DLL は を呼び出す必要があります Dot11ExtPostAssociateCompletion。

IHV Extensions DLL が関連付け後操作を開始できる場合、 Dot11ExtIhvPerformPostAssociate 関数はERROR_SUCCESSを返し、非同期的に操作を完了する必要があります。

関連付け後操作の詳細については、「関連付け 後操作」を参照してください。

要件

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

こちらもご覧ください

Dot11ExtPostAssociateCompletion

Dot11ExtIhvInitAdapter

DOT11_PORT_STATE

Dot11ExtIhvAdapterReset

NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION