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 處理程式函式。
[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) |