次の方法で共有

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

  • [アーティクル]
重要Native 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨です。 代わりに WLAN デバイス ドライバー インターフェイス (WDI) を使用してください。 WDI の詳細については、WLAN ユニバーサル Windows ドライバー モデル を参照してください。
 
IHV 拡張機能 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 オペレーティング システムで使用できます。
ターゲット プラットフォーム の デスクトップ
ヘッダー wlanihv.h (Wlanihv.h を含む)

関連項目

Dot11ExtIhvInitAdapter の

DOT11EXT_IHV_SECURITY_PROFILE

dot11ExtIhvPerformPreAssociate DOT11EXT_IHV_CONNECTIVITY_PROFILE の