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

  • [アーティクル]
大事なネイティブ 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨となりました。 代わりに WLAN デバイス ドライバー インターフェイス (WDI) を使用してください。 WDI の詳細については、「 WLAN ユニバーサル Windows ドライバー モデル」を参照してください。
 
IHV Extensions DLL は Dot11ExtSetCurrentProfile 関数を呼び出して、IHV で定義された接続とセキュリティ プロファイル フラグメントの設定を指定します。 これらのフラグメントは、現在のネットワーク プロファイルに適用されます。

構文

DOT11EXT_SET_CURRENT_PROFILE Dot11extSetCurrentProfile;

DWORD Dot11extSetCurrentProfile(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in, optional] PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in, optional] PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile
)
{...}

パラメーター

[in, optional] hDot11SvcHandle

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

[in, optional] hConnectSession

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

[in, optional] pIhvConnProfile

へのポインター DOT11EXT_IHV_CONNECTIVITY_PROFILE IHV プロファイルの接続設定を含む構造体です。

[in, optional] pIhvSecProfile

へのポインター DOT11EXT_IHV_SECURITY_PROFILE IHV プロファイルのセキュリティ設定を指定する構造体です。

戻り値

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

注釈

Dot11ExtSetCurrentProfile 関数を使用すると、IHV は、基本サービス セット (BSS) ネットワーク接続に使用されている現在のネットワーク プロファイルにカスタム接続とセキュリティ プロファイル フラグメントを追加できます。 プロファイル フラグメントは IHV 固有であり、 Native 802.11 IHV UI Extensions DLL を介してユーザーが使用できる接続またはセキュリティ拡張機能に適用されます。

IHV 拡張機能 DLL は、 Dot11ExtSetCurrentProfile 関数を呼び出すときに、次のガイドラインに従う必要があります。

  • IHV 拡張機能 DLL は、 の呼び出しを介して開始された事前関連付け操作を実行する場合にのみ Dot11ExtSetCurrentProfile を呼び出す必要があります。 Dot11ExtIhvPerformPreAssociate IHV ハンドラー関数。 関連付け前操作の詳細については、「関連付け 前操作」を参照してください。
  • IHV 拡張機能 DLL は、 の呼び出し内から Dot11ExtSetCurrentProfile を呼び出してはなりません。 Dot11ExtIhvPerformPreAssociate IHV ハンドラー関数。 Dot11ExtSetCurrentProfile は、 Dot11ExtIhvPerformPreAssociate の呼び出しを処理しているスレッドとは異なるスレッドから呼び出す必要があります。

要件

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

こちらもご覧ください

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE

Dot11ExtIhvPerformPreAssociate DOT11EXT_IHV_CONNECTIVITY_PROFILE