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

[アーティクル]
08/08/2023

大事なネイティブ 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨となりました。代わりに WLAN デバイスドライバーインターフェイス (WDI) を使用してください。 WDI の詳細については、「 WLAN ユニバーサル Windows ドライバーモデル」を参照してください。

オペレーティングシステムは Dot11ExtIhvCreateDiscoveryProfiles 関数を呼び出して、ネットワークプロファイルが存在しない基本的なサービスセット (BSS) ネットワークへの接続に使用できる一時的な接続とセキュリティプロファイルフラグメントを返します。

構文

DOT11EXTIHV_CREATE_DISCOVERY_PROFILES Dot11extihvCreateDiscoveryProfiles;

DWORD Dot11extihvCreateDiscoveryProfiles(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           BOOL bInsecure,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in, optional] PDOT11_BSS_LIST pConnectableBssid,
  [out]          PDOT11EXT_IHV_DISCOVERY_PROFILE_LIST pIhvDiscoveryProfileList,
  [out]          PDWORD pdwReasonCode
)
{...}

パラメーター

[in, optional] hIhvExtAdapter

ワイヤレス LAN (WLAN) アダプターを参照するために IHV 拡張機能 DLL によって使用されるハンドル。このハンドル値は、 Dot11ExtIhvInitAdapter IHV ハンドラー関数の以前の呼び出しによって指定されました。

[in] bInsecure

検出プロファイルのセキュリティ状態を示すブール値。 TRUE に設定すると、IHV 拡張機能 DLL は、ユーザー認証を伴うプロファイルなどのセキュリティで保護されたプロファイルのみを返すことができます。

[in, optional] pIhvProfileParams

へのポインター DOT11EXT_IHV_PROFILE_PARAMS 構造体。この構造体は、プロファイル拡張機能を適用する基本的なサービスセット (BSS) ネットワークの属性を定義します。

[in, optional] pConnectableBssid

BSS ネットワークから受信した 1 つ以上の 802.11 ビーコンまたはプローブ応答フレームを含む、 DOT11_BSS_LIST構造体へのポインター。この一覧は、WLAN アダプターによって最後に実行されたスキャン操作の結果から派生します。スキャン操作の詳細については、「 Native 802.11 Scan Operations」を参照してください。

メモ Windows Vista の場合、IHV 拡張機能 DLL では、インフラストラクチャの基本サービスセット (BSS) ネットワークのみがサポートされます。

[out] pIhvDiscoveryProfileList

へのポインター DOT11EXT_IHV_DISCOVERY_PROFILE_LIST IHV 検出プロファイルの一覧を指定する構造体です。

[out] pdwReasonCode

DWORD 値へのポインター。 Dot11ExtIhvCreateDiscoveryProfiles 関数の戻り値に関する追加情報を提供します。 IHV 拡張機能 DLL では、 * pdwReasonCode を L2cmn.h で定義されているL2_REASON_CODE_xxxx値に設定する必要があります。

戻り値

呼び出しが成功した場合、関数は ERROR_SUCCESSを返します。それ以外の場合は、Winerror.h で定義されたエラーコードが返されます。

注釈

WLAN アダプターがスキャン操作を完了すると、オペレーティングシステムは Dot11ExtIhvCreateDiscoveryProfiles を呼び出して、ネットワークプロファイルがユーザーによって作成されていない BSS ネットワークへの接続に使用できる一時的なプロファイルフラグメントを作成する場合があります。

Dot11ExtIhvCreateDiscoveryProfiles が呼び出されると、IHV 拡張機能 DLL は次のガイドラインに従う必要があります。

IHV 拡張機能 DLL が BSS ネットワークへの接続に使用できるプロファイルフラグメントを返すことができる場合、 Dot11ExtIhvCreateDiscoveryProfiles 関数はERROR_SUCCESSを返す必要があります。それ以外の場合、関数は Winerror.h で定義されているERROR_xxxx値から適切なエラーコードを返す必要があります。
IHV 拡張機能 DLL は、 Dot11ExtIhvCreateDiscoveryProfiles 関数の戻り値に関する詳細情報を提供します。 DLL では、 * pdwReasonCode を次のいずれかに設定する必要があります。
- L2_REASON_CODE_SUCCESS、BSS ネットワークの一覧に対してプロファイルフラグメントを返すことができる場合。
- BSS ネットワークの一覧に対してプロファイルフラグメントを返すことができない場合は、適切な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、Winclient.h、L2cmn.h を含む)