WiFi Framework C++ Edition

◆ SetProfileUserData()

int SetProfileUserData ( const GUID &  IfaceId,
const tstring ProfileName,
const unsigned long  DataSize,
const void *const  Data 
)

Sets the custom user data associated with a profile.

Parameters
IfaceIdThe ID of the interface.
ProfileNameThe name of the profile associated with the custom user data. Profile names are case-sensitive.
DataSizeThe size of Data, in bytes.
DataA pointer to the user data to be set.
Returns
If the function succeeds, the return value is wclCommon::WCL_E_SUCCESS. If the function fails, the return value may be one of the WCL return codes.

For every wireless WLAN profile used by the Native Wi-Fi AutoConfig service, Windows maintains the concept of custom user data. This custom user data is initially non-existent, but can be set by calling the SetProfileUserData method. The custom user data gets reset to empty any time the profile is modified by calling the SetProfile method.

Once custom user data has been set, this data can be accessed using the GetProfileUserData method.