Share via


MobileBroadbandModem.SetIsPassthroughEnabledAsync Method

Definition

Overloads

SetIsPassthroughEnabledAsync(Boolean)

Asynchronously enables or disables passthrough mode.

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.

public:
 virtual IAsyncOperation<MobileBroadbandModemStatus> ^ SetIsPassthroughEnabledAsync(bool value) = SetIsPassthroughEnabledAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<MobileBroadbandModemStatus> SetIsPassthroughEnabledAsync(bool const& value);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<MobileBroadbandModemStatus> SetIsPassthroughEnabledAsync(bool value);
function setIsPassthroughEnabledAsync(value)
Public Function SetIsPassthroughEnabledAsync (value As Boolean) As IAsyncOperation(Of MobileBroadbandModemStatus)

Parameters

value
Boolean

bool

True if passthrough should be enabled; otherwise, false.

Returns

An asynchronous operation that returns a MobileBroadbandModemStatus value on completion.

Attributes

Windows requirements

Device family
Windows 10 Fall Creators Update (introduced in 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v5.0)
App capabilities
cellularDeviceControl cellularDeviceIdentity

Remarks

Enabling passthrough mode allows the host to communicate with the SIM directly (the communication between the host and the SIM is passthrough). For example, to upgrade firmware. The miniport adapter doesn't send any application protocol data units (APDUs) to the card, and doesn't interfere at any time with the communication between the host and the SIM.

Applies to

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.

public:
 virtual IAsyncOperation<MobileBroadbandModemStatus> ^ SetIsPassthroughEnabledAsync(bool value, int slotindex) = SetIsPassthroughEnabledAsync;
/// [Windows.Foundation.Metadata.Overload("SetIsPassthroughEnabledWithSlotIndexAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<MobileBroadbandModemStatus> SetIsPassthroughEnabledAsync(bool const& value, int const& slotindex);
[Windows.Foundation.Metadata.Overload("SetIsPassthroughEnabledWithSlotIndexAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<MobileBroadbandModemStatus> SetIsPassthroughEnabledAsync(bool value, int slotindex);
function setIsPassthroughEnabledAsync(value, slotindex)
Public Function SetIsPassthroughEnabledAsync (value As Boolean, slotindex As Integer) As IAsyncOperation(Of MobileBroadbandModemStatus)

Parameters

value
Boolean

bool

A value of true to enable passthrough mode; false to disable it.

slotindex
Int32

int

The 0-based slot index (slot number) to enable or disable passthrough mode for.

Returns

An asynchronous object which, when it completes, contains a MobileBroadbandModemStatus value.

Attributes

Windows requirements

Device family
Windows 11 Insider Preview (introduced in 10.0.23504.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v15.0)
App capabilities
Microsoft.eSIMManagement_8wekyb3d8bbwe

Remarks

Enabling passthrough mode allows the host to communicate with the SIM directly (the communication between the host and the SIM is passthrough). For example, to upgrade firmware. The miniport adapter doesn't send any application protocol data units (APDUs) to the card, and doesn't interfere at any time with the communication between the host and the SIM.

Applies to