WifiConfig_GetClientIdentity function

Header: #include <applibs/wificonfig.h>

Gets the client identity of the network.

static int WifiConfig_GetClientIdentity(int networkId, WifiConfig_ClientIdentity *outIdentity);

Parameters

• networkId The ID of the network. WifiConfig_AddNetwork returns the network ID.

• outIdentity A pointer to a WifiConfig_ClientIdentity structure that receives the client identity associated with the specified network.

Errors

Returns -1 if an error is encountered and sets errno to the error value.

• EACCES: the application manifest doesn't include the EnterpriseWifiConfig capability.

• EAGAIN: the Wi-Fi device isn't ready yet.

• EFAULT: the outIdentity parameter is NULL.

• EINVAL: the networkId parameter is invalid.

• ENETDOWN: the Wi-Fi network interface is unavailable.

• ENODEV: the networkId parameter doesn't match any of the IDs of the stored networks.

Any other errno may also be specified; such errors aren't deterministic and there's no guarantee that the same behavior will be retained through system updates.

Return value

Returns 0 for success, or -1 for failure, in which case errno is set to the error value.

Application manifest requirements

The application manifest must include the EnterpriseWifiConfig capability.