1.10 WiFi Policy Interface

The WiFi Policy interface provides methods for getting and setting the enforcement for adhoc networks, WiFi connections, and wireless access point security level.

1.10.1 Data Types

Enforcement Types:

disable — Disable the setting and enforce immediately.

enable — Enable the setting and enforce immediately.

inherit — Immediately apply enforcement as defined by the current policy. Used to clear the script setting.

Signal Strength:

not_set — No policy is set; filter is ignored.

very_low

low

good

very_good

excellent

inherit — Immediately apply setting as defined by the current policy. Used to clear the script setting.

Security Level:

inherit — Immediately apply setting as defined by the current policy. Used to clear the script setting.

unsecured

secure — Any security level.

wep

wpa

wpa2

1.10.2 Adhoc WiFi Networks Methods

The Adhoc WiFi Networks methods get and set the enforcement for adhoc wireless networks.

string Query.GetAdHoc

Description:

Gets the effective enforcement for adhoc WiFi networks.The effective enforcement is determined by resolving any conflicts between the policy enforcement type and the script enforcement type. The script enforcement type overrides the policy enforcement type; if the script enforcement type is inherit, the policy enforcement type is used.

Returns:

Enabled if the device can connect to an adhoc wireless network or can be an adhoc network provider. Disabled if the device cannot connect to an adhoc network or cannot be a provider.

string Query.GetAdHocPolicy

Description:

Gets the enforcement, as set by policy, for adhoc wireless networks.

Returns:

Enabled if the device can connect to an adhoc wireless network or be an adhoc network provider. Disabled if the device cannot connect or be a provider.

string Query.GetAdHocScript

Description:

Gets the enforcement, as set by script, for adhoc wireless networks.

Returns:

Enabled if the device can connect to an adhoc wireless network or be an adhoc network provider. Disabled if the device cannot connect or be a provider.

int Action.SetAdHoc(string enforcement)

Description:

Sets the enforcement for adhoc wireless networks.

Parameters:

enforcement — One of the enforcement types listed in Section 1.10.1, Data Types.

1.10.3 Block WiFi Connections

The Block WiFi Connections methods get and set the enforcement for WiFi connections.

string Query.GetBlockWiFiConnection

Description:

Gets the effective enforcement for blocking connections to a WiFi network.The effective enforcement is determined by resolving any conflicts between the policy enforcement type and the script enforcement type. The script enforcement type overrides the policy enforcement type; if the script enforcement type is inherit, the policy enforcement type is used.

Returns:

Enabled if WiFi connections are blocked. Disabled if WiFi connections are allowed. If disabled, connections are based on availability and filter restrictions.

string Query.GetBlockWiFiConnectionPolicy

Description:

Gets the enforcement, as set by policy, for blocking connections to a WiFi network. If disabled, connections are based on availability and filter restrictions.

Returns:

Enabled if WiFi connections are blocked. Disabled if WiFi connections are allowed.If disabled, connections are based on availability and filter restrictions.

string Query.GetBlockWiFiConnectionScript

Description:

Gets the enforcement, as set by script, for blocking connections to a WiFi network.

Returns:

Enabled if WiFi connections are blocked. Disabled if WiFi connections are allowed. If disabled, connections are based on availability and filter restrictions.

int Action.SetBlockWiFiConnection(string enforcement)

Description:

Sets the enforcement for blocking WiFi connections.

Parameters:

enforcement — One of the enforcement types listed in Section 1.10.1, Data Types.

1.10.4 Minimum Security Level Methods

Minimum security level is used to filter out wireless networks that do not meet the minimum level. Devices cannot see or connect to the removed wireless networks. The security level is inclusive from inherit to wpa2, as listed in Section 1.10.1, Data Types. For example if wpa is chosen, networks that support wpa and wpa2 security pass the filter, but unsecured networks and wep networks are filtered out.

The Minimum Security Level methods get and set the minimum security level requirement for a wireless network.

string Query.GetMinWiFiSecurityLevel

Description:

Gets the effective enforcement for the minimum security level. The effective enforcement is determined by resolving any conflicts between the policy enforcement type and the script enforcement type. The script enforcement type overrides the policy enforcement type; if the script enforcement type is inherit, the policy enforcement type is used.

Returns:

One of the security levels listed in Section 1.10.1, Data Types.

string Query.GetMinWiFiSecurityLevelPolicy

Description:

Gets the minimum security level, as set by policy.

Returns:

One of the security levels listed in Section 1.10.1, Data Types.

string Query.GetMinWiFiSecurityLevelScript

Description:

Gets the minimum security level, as set by script.

Returns:

One of the security levels listed in Section 1.10.1, Data Types.

int Action.SetMinWiFiSecurityLevelEnforcement(string enforcement)

Description:

Sets the enforcement for minimum security level.

Parameters:

enforcement — One of the enforcement types listed in Section 1.10.1, Data Types.

1.10.5 Minimum Signal Strength Methods

Minimum signal strength level is used to filter out wireless access points that do not meet the minimum signal strength. Devices cannot see or connect to the removed access point. The signal strength is inclusive from inherit to not_set, as listed in Section 1.10.1, Data Types. For example if very_good is chosen, access points that have very_good and excellent signal strength pass the filter, but access points with very_low, low, and good signal strengths are filtered out.

The Minimum Signal Strength methods get and set the minimum signal strength requirement for wireless access points.

string Query.GetMinWiFiSignalStrength

Description:

Gets the effective enforcement for the minimum signal strength. The effective enforcement is determined by resolving any conflicts between the policy enforcement type and the script enforcement type. The script enforcement type overrides the policy enforcement type; if the script enforcement type is inherit, the policy enforcement type is used.

Returns:

One of the signal strengths listed in Section 1.10.1, Data Types.

string Query.GetMinWiFiSignalStrengthPolicy

Description:

Gets the minimum security level, as set by policy.

Returns:

One of the signal strengths listed in Section 1.10.1, Data Types.

string Query.GetMinWiFiSignalStrengthScript

Description:

Gets the minimum security level, as set by script.

Returns:

One of the signal strengths listed in Section 1.10.1, Data Types.

int Action.SetMinWiFiSignalStrengthEnforcement(string enforcement)

Description:

Sets the enforcement for minimum security level.

Parameters:

enforcement — One of the enforcement types listed in Section 1.10.1, Data Types.