NetworkDeviceStatus Enum

Definition

Namespace:

Windows.Networking.NetworkOperators

Describes the readiness of a device to connect to a wireless network.

Note

This functionality is available only to mobile operator apps and UWP apps given privileged access by mobile network operators.

If you want to use this API and publish your app to the Microsoft Store, then you'll need special approval. For more information, see the Restricted capabilities section in the App capability declarations topic.

public enum class NetworkDeviceStatus

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class NetworkDeviceStatus

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum NetworkDeviceStatus

var value = Windows.Networking.NetworkOperators.NetworkDeviceStatus.deviceNotReady

Public Enum NetworkDeviceStatus

Inheritance

Enum

NetworkDeviceStatus

Attributes

ContractVersionAttribute

Windows requirements

Device family	Windows 10 (introduced in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduced in v1.0)
App capabilities	cellularDeviceControl cellularDeviceIdentity

Fields

Name	Value	Description
DeviceNotReady	0	The mobile broadband device is off.
DeviceReady	1	The device is powered on and ready for mobile broadband operations.
SimNotInserted	2	The mobile broadband device does not have a SIM card.
BadSim	3	The SIM card is not valid. This can occur when PIN Unblock Key attempts have exceeded the limit.
DeviceHardwareFailure	4	The mobile broadband device hardware is not responding.
AccountNotActivated	5	A subscription account for the mobile broadband device is not active.
DeviceLocked	6	The mobile broadband device is locked by a PIN or password preventing the device from initializing and registering with a wireless network.
DeviceBlocked	7	The mobile broadband device is blocked by a PIN or password preventing the device from initializing and registering with a wireless network.

Remarks

Mobile operator UWP app can have access to different states of the device. Access to the device states such as device readiness, account activation state, and device lock status are made available through the NetworkDeviceStatus enumeration. The radio state information is available through the CurrentRadioState enumeration. Note that these are two different states. For example, a radio state Off does not translate to a DeviceNotReady state and vice versa.