MobileBroadbandModem Class

Reference

Definition

Namespace:: Windows.Networking.NetworkOperators

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

Represents a mobile broadband modem.

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 ref class MobileBroadbandModem sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class MobileBroadbandModem final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class MobileBroadbandModem

Public NotInheritable Class MobileBroadbandModem

Inheritance: Object Platform::Object IInspectable MobileBroadbandModem

Attributes: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

Remarks

Version history

Windows version	SDK version	Value added
1709	16299	GetIsPassthroughEnabledAsync
1709	16299	SetIsPassthroughEnabledAsync
1803	17134	IsInEmergencyCallMode
1803	17134	IsInEmergencyCallModeChanged
1803	17134	TryGetPcoAsync

Properties

CurrentAccount	Gets the MobileBroadbandAccount associated currently with the mobile broadband modem.
CurrentNetwork	Gets an object that describes the mobile broadband network that this modem us currently attached to.
DeviceInformation	Gets the MobileBroadbandDeviceInformation for the mobile broadband modem.
DeviceServices	Gets a list of the device services available for the mobile broadband modem.
IsInEmergencyCallMode	Gets a value indicating whether the mobile broadband modem is in emergency call mode.
IsResetSupported	Gets a value indicating whether the mobile broadband modem allows a reset operation.
MaxDeviceServiceCommandSizeInBytes	Gets the maximum device service command size, in bytes, for the mobile broadband modem.
MaxDeviceServiceDataSizeInBytes	Gets the maximum device service data size, in bytes, for the mobile broadband modem.

Methods

FromId(String)	Determine if a mobile broadband device is a Wireless WAN device.
GetCurrentConfigurationAsync()	Asynchronously retrieves mobile broadband modem configuration information.
GetDefault()	Determines the default mobile broadband modem.
GetDeviceSelector()	Gets a device selector for the mobile broadband modem.
GetDeviceService(Guid)	Gets a specific device service for the mobile broadband modem.
GetIsPassthroughEnabled(Int32)	Retrieves a value indicating whether passthrough mode is enabled (for either the active or inactive slot, for Dual Sim Single Active devices). 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 to request special approval to use the custom capability Microsoft.eSIMManagement_8wekyb3d8bbwe. For more info, see Custom capabilities.
GetIsPassthroughEnabledAsync()	Gets a value indicating whether passthrough mode is enabled.
GetIsPassthroughEnabledAsync(Int32)	Asynchronously retrieves a value indicating whether passthrough mode is enabled (for either the active or inactive slot, for Dual Sim Single Active devices). 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 to request special approval to use the custom capability Microsoft.eSIMManagement_8wekyb3d8bbwe. For more info, see Custom capabilities.
ResetAsync()	Asynchronously performs a reset operation on the mobile broadband modem.
SetIsPassthroughEnabled(Boolean, Int32)	Enables or disables passthrough mode (for either the active or inactive slot, for Dual Sim Single Active devices). 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 to request special approval to use the custom capability Microsoft.eSIMManagement_8wekyb3d8bbwe. For more info, see Custom capabilities.
SetIsPassthroughEnabledAsync(Boolean, Int32)	Asynchronously enables or disables passthrough mode (for either the active or inactive slot, for Dual Sim Single Active devices). 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 to request special approval to use the custom capability Microsoft.eSIMManagement_8wekyb3d8bbwe. For more info, see Custom capabilities.
SetIsPassthroughEnabledAsync(Boolean)	Asynchronously enables or disables passthrough mode.
TryGetPcoAsync()	Asynchronously retrieves the Protocol Configuration Options (PCO) data for the modem.

Events

IsInEmergencyCallModeChanged

Occurs when the mobile broadband modem either enters or exits emergency call mode.

Applies to

Jaa