Dot11ExtSetProfileCustomUserData (Compact 2013)
3/26/2014
The IHV Extensions DLL calls this function to save data to the system registry that is specific to the current user and network profile used for the basic service set (BSS) network connection.
Syntax
DWORD WINAPI Dot11ExtSetProfileCustomUserData(
HANDLE hDot11SvcHandle,
HANDLE hConnectSession,
DWORD dwSessionID,
DWORD dwDataSize,
LPVOID pvData
);
Parameters
- hDot11SvcHandle
[in] The handle that is used by the operating system to reference the WLAN adapter. This handle value was specified through a previous call to the Dot11ExtIhvInitAdapter IHV Handler function.
- hConnectSession
[in] The handle that is used by the operating system to reference the connection session with the BSS network. This handle value was specified through a previous call to the Dot11ExtIhvPerformPreAssociate IHV Handler function.
- dwSessionID
[in] The session identifier (session ID) of the current user
- dwDataSize
[in] The size, in bytes, of the buffer referenced by pvData
- pvData
A pointer to a caller-allocated buffer, which contains the data in a format that is defined by the HIV
Return Value
If the call succeeds, the function returns ERROR_SUCCESS. Otherwise, it returns an error code defined in Winerror.h.
Remarks
When it calls the Dot11ExtSetProfileCustomUserData function, the IHV Extensions DLL must follow these guidelines:
- The IHV Extensions DLL must call Dot11ExtSetCurrentProfile when it performs a pre-association operation initiated through a call to the Dot11ExtIhvPerformPreAssociate IHV Handler function only.
- The IHV Extensions DLL must not call Dot11ExtSetCurrentProfile from inside the call to the Dot11ExtIhvPerformPreAssociate IHV Handler function. Dot11ExtSetCurrentProfile must be called from a different thread than the one which is processing the call to Dot11ExtIhvPerformPreAssociate.
- The operating system will not encrypt the data referenced by the pvData parameter before storing it within the system registry. The IHV Extensions DLL should use its own encryption algorithm to encrypt the data before calling Dot11ExtSetProfileCustomUserData.
The following points apply to the data saved within the system registry through the Dot11ExtSetProfileCustomUserData function:
- The operating system stores the data under the HKEY_CURRENT_USER key for the user who is referenced by the handle passed in the hUserToken parameter.
- The IHV Extensions DLL can query the user data through a call to the Dot11ExtGetProfileCustomUserData function.
Requirements
Header |
wlanihv.h |
See Also
Reference
Native 802.11 IHV Extensibility Functions
Dot11ExtIhvInitAdapter
Dot11ExtIhvPerformPreAssociate
Dot11ExtSetCurrentProfile
Native 802.11 IHV Extensions DLL