Partager via


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