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

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

IHV 拡張機能 DLL は Dot11ExtSetVirtualStationAPProperties 関数を呼び出して、現在の IHV プロファイル接続を指定します。

構文

DOT11EXT_SET_VIRTUAL_STATION_AP_PROPERTIES Dot11extSetVirtualStationApProperties;

DWORD Dot11extSetVirtualStationApProperties(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwNumProperties,
  [in]           PDOT11EXT_VIRTUAL_STATION_AP_PROPERTY pProperties,
                 LPVOID pvReserved
)
{...}

パラメーター

[in, optional] hDot11SvcHandle

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

[in, optional] hConnectSession

基本サービス セット (BSS) ネットワークとの現在の接続セッションを参照するためにオペレーティング システムによって使用されるハンドル。 このハンドル値は、 への以前の呼び出しによって hConnectSession パラメーターとして受信されました。 Dot11ExtIhvPerformPreAssociate IHV ハンドラー関数。

[in] dwNumProperties

pProperties パラメーターが指す構造体の配列内の要素の数。

[in] pProperties

の配列へのポインター DOT11EXT_VIRTUAL_STATION_AP_PROPERTY 仮想 802.11 ステーションが現在の接続セッションでホストしようとしているアクセス ポイント (AP) のプロパティを指定する構造体です。

pvReserved

このパラメーターはオペレーティング システムで使用するために予約されており、 NULL にする必要があります。

戻り値

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

注釈

現在の IHV プロファイル接続がアクセス ポイント (AP) であり、IHV 拡張機能 DLL が AP で使用される設定をオペレーティング システムに提供できる場合、オペレーティング システムは、オペレーティング システムから AP 関連のサービスを要求するユーザーに追加情報を提供できます。

IHV 拡張機能 DLL が Dot11ExtSetVirtualStationAPProperties を呼び出す場合は、 を呼び出す前に呼び出す必要があります。 Dot11ExtIhvPerformPreAssociate IHV ハンドラー関数。 関連付け前操作が正常に完了する前に Dot11ExtSetVirtualStationAPProperties が呼び出されない場合、オペレーティング システムは IHV プロファイルの性質を想定しません。

要件

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

こちらもご覧ください

Dot11ExtIhvPerformPreAssociate

Dot11ExtIhvInitAdapter

DOT11EXT_VIRTUAL_STATION_AP_PROPERTY