DOT11EXTIHV_VALIDATE_PROFILE コールバック関数 (wlanihv.h)
構文
DOT11EXTIHV_VALIDATE_PROFILE Dot11extihvValidateProfile;
DWORD Dot11extihvValidateProfile(
[in, optional] HANDLE hIhvExtAdapter,
[in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
[in] PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
[in] PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
[out] PDWORD pdwReasonCode
)
{...}
パラメーター
[in, optional] hIhvExtAdapter
ワイヤレス LAN (WLAN) アダプターを参照するために IHV 拡張機能 DLL によって使用されるハンドル。 このハンドル値は、 Dot11ExtIhvInitAdapter IHV ハンドラー関数の以前の呼び出しによって指定されました。
[in, optional] pIhvProfileParams
へのポインター DOT11EXT_IHV_PROFILE_PARAMS 構造体。 この構造体は、プロファイル拡張機能を適用する基本サービス セット (BSS) ネットワークの属性を定義します。
[in] pIhvConnProfile
へのポインター DOT11EXT_IHV_CONNECTIVITY_PROFILE IHV プロファイルの接続設定を含む構造体です。
[in] pIhvSecProfile
へのポインター DOT11EXT_IHV_SECURITY_PROFILE IHV プロファイルのセキュリティ設定を含む構造体です。
[out] pdwReasonCode
Dot11ExtIhvValidateProfile 関数の戻り値に関する追加情報を提供する DWORD 値へのポインター。 IHV Extensions DLL では、 * pdwReasonCode を L2cmn.h で定義されているL2_REASON_CODE_xxxx値に設定する必要があります。
戻り値
呼び出しが成功した場合、関数はERROR_SUCCESSを返します。 それ以外の場合は、Winerror.h で定義されたエラー コードが返されます。
注釈
オペレーティング システムは Dot11ExtIhvValidateProfile 関数を呼び出して、プロファイルが処理または保存される前に、ネットワーク プロファイルのユーザー指定の設定を確認します。
Dot11ExtIhvValidateProfile 関数が呼び出されると、IHV Extensions DLL は次のガイドラインに従います。
- IHV 拡張機能 DLL は、ユーザー指定のプロファイル設定が、プロファイルが適用される基本サービス セット (BSS) ネットワークの一般的な属性に対して有効であることを確認します。 BSS ネットワーク属性は、 pIhvProfileParams パラメーターを介して参照されます。
- ユーザー データがネットワーク プロファイル拡張機能に対して有効な場合、 Dot11ExtIhvValidateProfile はERROR_SUCCESSを返す必要があります。 それ以外の場合、関数は Winerror.h で定義されているERROR_xxxx値から適切なエラー コードを返す必要があります。
-
IHV Extensions DLL は、ユーザー データの検証結果に関する詳細情報を提供します。 DLL では、 * pdwReasonCode を次のいずれかに設定する必要があります。
- ユーザー データが有効な場合は、L2_REASON_CODE_SUCCESSします。
- ユーザー データが無効な場合は、適切なL2_REASON_CODE_xxxxエラー値。
- ユーザー データの有効性に関係なく、L2_REASON_CODE_IHV_BASE から (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) までの範囲の IHV 定義値。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | wlanihv.h (Wlanihv.h、L2cmn.h を含む) |