Class

NEHotspotConfigurationManager

A manager that applies and removes hotspot configurations of Wi-Fi networks.

Declaration

@interface NEHotspotConfigurationManager : NSObject

Overview

When your app creates a new hotspot configuration using NEHotspotConfiguration and applies it to a Wi-Fi network or attempts to update a previously configured network, the device prompts the user for approval. Without explicit user consent, your app can't make configuration changes.

Your app can use removeConfigurationForHS20DomainName: or removeConfigurationForSSID: to delete a configuration that it has added, but not a configuration added by another app or user. The user can also delete configured networks using Settings > Wi-Fi.

When your app is uninstalled, iOS removes the configurations of all networks your app has configured, including their keychain entries.

Hotspot Configuration Manager errors are listed in NEHotspotConfigurationError.

Topics

Creating Configurations

sharedManager

Instantiates NEHotspotConfigurationManager as a singleton, so it can be shared.

- applyConfiguration:completionHandler:

Adds or updates a Wi-Fi network configuration after prompting the user for permission, and then attempts to join the network under certain conditions.

Getting a List of Configurations

- getConfiguredSSIDsWithCompletionHandler:

Returns the SSIDs or the names of the Wi-Fi hotspot domains that your app has configured and invokes an optional completion handler.

Removing Configuration

- removeConfigurationForHS20DomainName:

Removes a Wi-Fi hotspot configuration, identified by a Hotspot 2.0 domain name, that your app previously added.

- removeConfigurationForSSID:

Removes a Wi-Fi configuration, identified by an SSID, that your app previously added.

Entitlements

Hotspot Configuration Entitlement

A Boolean value indicating whether your app can use the hotspot manager to configure Wi-Fi networks.

Key: com.apple.developer.networking.HotspotConfiguration

Relationships

Inherits From

See Also

Wi-Fi Network Configuration

NEHotspotConfiguration

Configuration settings for a Wi-Fi network.

NEHotspotEAPSettings

Extensible Authentication Protocol settings for configuring WPA and WPA2 enterprise Wi-Fi networks.

NEHotspotHS20Settings

Settings for configuring Hotspot 2.0 Wi-Fi networks.