次の方法で共有


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

重要Native 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨です。 代わりに WLAN デバイス ドライバー インターフェイス (WDI) を使用してください。 WDI の詳細については、WLAN ユニバーサル Windows ドライバー モデル を参照してください。
 
IHV 拡張機能 DLL は、dot11ExtSetProfileCustomUserData 関数を呼び出して、基本サービス セット (BSS) ネットワーク接続に使用されている現在のユーザーとネットワーク プロファイルに固有のデータをシステム レジストリ内に保存します。

構文

DOT11EXT_SET_PROFILE_CUSTOM_USER_DATA Dot11extSetProfileCustomUserData;

DWORD Dot11extSetProfileCustomUserData(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwSessionID,
  [in]           DWORD dwDataSize,
  [in]           LPVOID pvData
)
{...}

パラメーター

[in, optional] hDot11SvcHandle

オペレーティング システムがワイヤレス LAN (WLAN) アダプターを参照するために使用するハンドル。 このハンドル値は、Dot11ExtIhvInitAdapter IHV ハンドラー関数への以前の呼び出しによって指定されました。

[in, optional] hConnectSession

BSS ネットワークとの接続セッションを参照するためにオペレーティング システムによって使用されるハンドル。 このハンドル値は、前の呼び出しで指定されたdot11ExtIhvPerformPreAssociate IHV ハンドラー関数を します。

[in] dwSessionID

現在のユーザーのセッション識別子 (セッション ID)。

[in] dwDataSize

pvData によって参照されるバッファーのサイズ (バイト単位)。

[in] pvData

呼び出し元によって割り当てられたバッファーへのポインター。IHV によって定義された形式でデータが格納されます。

戻り値

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

備考

オペレーティング システムは、システム レジストリ内に格納する前に、pvData パラメーターによって参照されるデータを暗号化しません。 IHV 拡張機能 DLL では、Dot11ExtSetProfileCustomUserData を呼び出す前に、独自の暗号化アルゴリズムを使用してデータを暗号化必要があります。

Native Wifi AutoConfig サービスで使用されるすべてのワイヤレス WLAN プロファイルについて、Windows はカスタム ユーザー データの概念を維持します。 このカスタム ユーザー データは最初は存在しませんが、Dot11ExtSetProfileCustomUserData 関数 呼び出すことによって設定できます。 カスタム ユーザー データは、プロファイルが変更されるたびに空にリセットされます。Dot11ExtSetCurrentProfile 関数を します。

カスタム ユーザー データが設定された後は、〘Dot11ExtGetProfileCustomUserData 関数を します。 オペレーティング システムは、dwSessionID パラメーターで渡されたハンドルによって参照されるユーザーのシステム レジストリ HKEY_CURRENT_USER キーの下にデータを格納します。

必要条件

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

関連項目

Dot11ExtIhvInitAdapter

Dot11ExtSetCurrentProfile

dot11ExtIhvPerformPreAssociate Dot11ExtGetProfileCustomUserData