DOT11EXT_SET_CURRENT_PROFILE コールバック関数 (wlanihv.h)
構文
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 を含む) |