DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA回呼函式 (wlanihv.h)
語法
DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA Dot11extGetProfileCustomUserData;
DWORD Dot11extGetProfileCustomUserData(
[in, optional] HANDLE hDot11SvcHandle,
[in, optional] HANDLE hConnectSession,
[in] DWORD dwSessionID,
[out] DWORD *pdwDataSize,
[out] LPVOID *ppvData
)
{...}
參數
[in, optional] hDot11SvcHandle
操作系統用來參考無線 LAN (WLAN) 適配卡的句柄。 這個句柄值是透過 先前呼叫 Dot11ExtIhvInitAdapter IHV Handler 函式來指定。
[in, optional] hConnectSession
操作系統用來參考聯機會話與基本服務集的句柄， (BSS) 網路。 這個句柄值是透過先前對的呼叫所指定 Dot11ExtIhvPerformPreAssociate IHV 處理程式函式。
[in] dwSessionID
會話標識碼 (目前使用者的會話標識碼) 。
[out] pdwDataSize
呼叫端提供的變數指標，可儲存 ppvData 所參考之緩衝區的大小，以位元組為單位。
[out] ppvData
指標變數的位址，儲存包含用戶數據的緩衝區位址。
傳回值
如果呼叫成功，函式會傳回ERROR_SUCCESS。 否則，它會傳回 Winerror.h 中定義的錯誤碼。
備註
從系統登錄讀取數據之後，操作系統不會解密 ppvData 參數所參考的數據。 IHV 延伸模組 DLL 應該使用自己的解密演算法，在呼叫 Dot11ExtGetProfileCustomUserData 之後解密數據。
針對 Native Wifi AutoConfig 服務所使用的每個無線 WLAN 配置檔，Windows 會維護自定義用戶數據的概念。 這個自定義用戶數據一開始不存在，但可以藉由呼叫 來設定 Dot11ExtSetProfileCustomUserData 函式。 每當呼叫 來修改配置檔時，自定義用戶數據就會重設為空白 Dot11ExtSetCurrentProfile 函式 。
設定自定義用戶數據之後，可以使用 Dot11ExtGetProfileCustomUserData 函式來存取此數據。
呼叫端會負責使用 Dot11ExtFreeBuffer 函式釋放為 ppvData 參數所指向之緩衝區配置的記憶體。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
| 目標平台 | 桌面 |
| 標頭 | wlanihv.h (包含 Wlanihv.h) |