Instance Property

joinOnce

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

Declaration

@property BOOL joinOnce;

Discussion

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

SSID

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

SSIDPrefix

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

lifeTimeInDays

The number of days the network retains the associated configuration.

hidden

A Boolean value that indicates the visibility of the SSID.