PropertyID.CaptivePortalPolicy Field

public const Int32 CaptivePortalPolicy = "value"

Public Const CaptivePortalPolicy As Int32 = "value"

Field Value

Captive Portal is the feature that detects and manages network connections requiring user interaction, such as logging in or accepting terms and conditions. A captive portal is typically encountered in public Wi-Fi networks, like those in cafes, airports, or hotels, where the user is redirected to a web page to enter credentials or agree to terms before accessing the internet.

So, according to the mode selected with this property, networks requiring this kind of authentication can be automatically disconnected, or user could be or not be prompted to authenticate in order to have access to internet.

The class of the property is CaptivePortalPolicy.

Note on Captive Portal and Wi-Fi Settings: When the Captive Portal is set to CaptivePortalPolicy.DISCONNECTED, while the Wi-Fi module property WIFI_NO_INTERNET_EXPECTED is configured to either WifiNoInternetExpected.RECONNECT_VERBOSE or WifiNoInternetExpected.RECONNECT_QUIET a conflict arises. In this scenario, the device attempts to auto-reconnect to a network that has no internet access, leading to a repetitive cycle of "Connecting > ... > Checking for internet access > back to Connecting". This behavior can be visually distracting to users, as the Wi-Fi icon keeps changing, creating an unintended and somewhat humorous appearance.

To ensure coherent functionality, it is crucial that when the Captive Portal is set to CaptivePortalPolicy.DISCONNECTED, the WIFI_NO_INTERNET_EXPECTED property is also set to WifiNoInternetExpected.DONT_RECONNECT. This alignment prevents the device from continually trying to connect to a network that is known to have no internet access, thus improving the user experience and eliminating unnecessary distractions.

[Android Documentation]

Reference