Instance Property


Restricts the lifetime of a configuration to the operating status of the app that created it.


@property BOOL joinOnce;


Optional. When joinOnce is set to true, the hotspot remains configured and connected only as long as the app that configured it is running in the foreground. The hotspot is disconnected and its configuration is removed when any of the following events occurs:

  • The app stays in the background for more than 15 seconds.

  • The device sleeps.

  • The app crashes, quits, or is uninstalled.

  • The app connects the device to a different Wi-Fi network.

  • The user connects the device to a different Wi-Fi network.

To disconnect the device from a hotspot configured with joinOnce set to true, call removeConfigurationForSSID:.

See Also

Accessing Configuration Properties


The SSID of an open, WEP, WPA/WPA2 personal, or WPA/WPA2 enterprise Wi-Fi network.


The string used to match networks against a known SSID prefix.


The number of days the network retains the associated configuration.


A Boolean value that indicates the visibility of the SSID.