次の方法で共有

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

  • [アーティクル]
重要Native 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

Dot11ExtIhvCreateDiscoveryProfiles 関数の戻り値に関する追加情報を提供する DWORD 値へのポインター。 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 オペレーティング システムで使用できます。
ターゲット プラットフォーム の デスクトップ
ヘッダー wlanihv.h (Wlanihv.h、Winclient.h、L2cmn.h を含む)

関連項目

DOT11EXT_IHV_DISCOVERY_PROFILE_LIST

DOT11_BSS_LIST

Dot11ExtIhvInitAdapter の

Dot11ExtFreeBuffer の

Dot11ExtAllocateBuffer の

DOT11EXT_IHV_PROFILE_PARAMS