次の方法で共有


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

大事なネイティブ 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 を含む)

こちらもご覧ください

DOT11EXT_IHV_DISCOVERY_PROFILE_LIST

DOT11_BSS_LIST

Dot11ExtIhvInitAdapter

Dot11ExtFreeBuffer

Dot11ExtAllocateBuffer

DOT11EXT_IHV_PROFILE_PARAMS