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 拡張機能 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 の