共用方式為


DOT11EXT_SET_PROFILE_CUSTOM_USER_DATA回呼函式 (wlanihv.h)

重要 Windows 10 和更新版本中已淘汰 Native 802.11 無線 LAN 介面。 請改用 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 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)

另請參閱

Dot11ExtIhvInitAdapter

Dot11ExtSetCurrentProfile

Dot11ExtIhvPerformPreAssociate Dot11ExtGetProfileCustomUserData