qwf_wifi_SetPassphrase()

Set a passphrase before creating or updating a Saved Network profile

Synopsis:

#include <qwf/qwf_wifi.h>

qwf_wifi_Results_e qwf_wifi_SetPassphrase(qwf_Context_t *pCtx,
                                          char *pPassphrase);

Arguments:

pCtx: A pointer to the QWF service context created by qwf_Init()
pPassphrase: A NULL-terminated string storing the passphrase for PSK authentication

Library:

qwf_interface

Description:

This function sets a passphrase to be used for WPA-PSK or WPA-PSK2 authentication. The client application must call this function to temporarily save the passphrase before calling qwf_wifi_CreateSavedNetwork() or qwf_wifi_UpdateSavedNetwork().

After the Saved Network profile is created or updated, the temporary passphrase is reset to an empty string. At this point, the passphrase is part of the persisted profile, and is used when connecting to the associated access point.

The passphrase must be at least 8 and no more than 64 characters. If it's too long, it gets truncated; if it's too short, the function fails.

Returns:

WIFI_OK Successful result

WIFI_ERR_PARAM A pointer argument is NULL or the passphrase is too short