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 Handler 函式來指定。
[in, optional] hConnectSession
作系統用來參考與 BSS 網路的聯機會話的句柄。 這個句柄值是透過先前對的呼叫來指定 Dot11ExtIhvPerformPreAssociate IHV Handler 函式。
[in] dwSessionID
目前使用者的會話標識碼(會話標識符)。
[in] dwDataSize
pvData 所參考之緩衝區的大小,以位元組為單位, 。
[in] pvData
呼叫端配置的緩衝區指標,其中包含IHV所定義格式的數據。
傳回值
如果呼叫成功,函式會傳回ERROR_SUCCESS。 否則,它會傳回 Winerror.h 中定義的錯誤碼。
言論
在系統登錄中儲存之前,作系統不會加密 pvData 參數所參考的數據。 IHV 延伸模組 DLL 應該使用自己的加密演算法,在呼叫 dot11ExtSetProfileCustomUserData 之前先加密數據。
針對 Native Wifi AutoConfig 服務所使用的每個無線 WLAN 配置檔,Windows 會維護自定義用戶數據的概念。 此自定義用戶數據一開始不存在,但可以藉由呼叫 dot11ExtSetProfileCustomUserData 函式來設定。 每當呼叫 來修改配置檔時,自定義用戶數據就會重設為空白 Dot11ExtSetCurrentProfile 函式。
設定自定義使用者數據之後,可以使用 來存取此數據 Dot11ExtGetProfileCustomUserData 函式。 作系統會將數據儲存在系統登錄HKEY_CURRENT_USER機碼底下,供傳入 dwSessionID 參數之句柄所參考的使用者。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows作系統中使用。 |
目標平臺 | 桌面 |
標頭 | wlanihv.h (包括 Wlanihv.h) |