DOT11EXT_SET_PROFILE_CUSTOM_USER_DATA コールバック関数 (wlanihv.h)
構文
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 Extensions DLL では、 Dot11ExtSetProfileCustomUserData を呼び出す前に、独自の暗号化アルゴリズムを使用してデータを暗号化する必要があります。
Native Wifi AutoConfig サービスで使用されるすべてのワイヤレス WLAN プロファイルについて、Windows ではカスタム ユーザー データの概念が維持されます。 このカスタム ユーザー データは、最初は存在しないが、 Dot11ExtSetProfileCustomUserData 関数を呼び出すことによって設定できます。 カスタム ユーザー データは、 を呼び出してプロファイルが変更されるたびに空にリセットされます。 Dot11ExtSetCurrentProfile 関数。
カスタム ユーザー データが設定されると、 Dot11ExtGetProfileCustomUserData 関数。 オペレーティング システムは、 dwSessionID パラメーターで渡されたハンドルによって参照されるユーザーのシステム レジストリ HKEY_CURRENT_USER キーの下にデータを格納します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | wlanihv.h (Wlanihv.h を含む) |