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

  • [アーティクル]
大事なネイティブ 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 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 定義値。
Native 802.11 XML スキーマの詳細については、Microsoft Windows SDKドキュメントを参照してください。

要件

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

こちらもご覧ください

DOT11EXT_IHV_CONNECTIVITY_PROFILE

DOT11EXT_IHV_PROFILE_PARAMS

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE