次の方法で共有

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

  • [アーティクル]
重要Native 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨です。 代わりに WLAN デバイス ドライバー インターフェイス (WDI) を使用してください。 WDI の詳細については、WLAN ユニバーサル Windows ドライバー モデル を参照してください。
 
オペレーティング システムは、Dot11ExtIhvValidateProfile 関数を呼び出して、ネットワーク プロファイルに対して入力されたユーザー データを検証します。 IHV 拡張機能 DLL は、IHV によって定義された接続とセキュリティ プロファイルのフラグメントのデータの検証のみを担当します。

構文

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 拡張機能 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 拡張機能 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 定義値。
Native 802.11 XML スキーマの詳細については、Microsoft Windows SDK のドキュメントを参照してください。

必要条件

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

関連項目

DOT11EXT_IHV_CONNECTIVITY_PROFILE

DOT11EXT_IHV_PROFILE_PARAMS

Dot11ExtIhvInitAdapter の

DOT11EXT_IHV_SECURITY_PROFILE