TelephonyManager.IccOpenLogicalChannel Method

[Android.Runtime.Register("iccOpenLogicalChannel", "(Ljava/lang/String;)Landroid/telephony/IccOpenLogicalChannelResponse;", "GetIccOpenLogicalChannel_Ljava_lang_String_Handler")]
public virtual Android.Telephony.IccOpenLogicalChannelResponse? IccOpenLogicalChannel (string? AID);

[<Android.Runtime.Register("iccOpenLogicalChannel", "(Ljava/lang/String;)Landroid/telephony/IccOpenLogicalChannelResponse;", "GetIccOpenLogicalChannel_Ljava_lang_String_Handler")>]
abstract member IccOpenLogicalChannel : string -> Android.Telephony.IccOpenLogicalChannelResponse
override this.IccOpenLogicalChannel : string -> Android.Telephony.IccOpenLogicalChannelResponse

Parameters

Returns

an IccOpenLogicalChannelResponse object.

Attributes

RegisterAttribute

Remarks

Opens a logical channel to the ICC card.

Input parameters equivalent to TS 27.007 AT+CCHO command.

Requires Permission: android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE or that the calling app has carrier privileges (see #hasCarrierPrivileges).

This member is deprecated. Replaced by #iccOpenLogicalChannel(String, int)

Java documentation for android.telephony.TelephonyManager.iccOpenLogicalChannel(java.lang.String).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

[Android.Runtime.Register("iccOpenLogicalChannel", "(Ljava/lang/String;I)Landroid/telephony/IccOpenLogicalChannelResponse;", "GetIccOpenLogicalChannel_Ljava_lang_String_IHandler", ApiSince=26)]
public virtual Android.Telephony.IccOpenLogicalChannelResponse? IccOpenLogicalChannel (string? AID, int p2);

[<Android.Runtime.Register("iccOpenLogicalChannel", "(Ljava/lang/String;I)Landroid/telephony/IccOpenLogicalChannelResponse;", "GetIccOpenLogicalChannel_Ljava_lang_String_IHandler", ApiSince=26)>]
abstract member IccOpenLogicalChannel : string * int -> Android.Telephony.IccOpenLogicalChannelResponse
override this.IccOpenLogicalChannel : string * int -> Android.Telephony.IccOpenLogicalChannelResponse

Parameters

Returns

an IccOpenLogicalChannelResponse object.

Attributes

RegisterAttribute

Remarks

Opens a logical channel to the ICC card.

This operation wraps two APDU instructions: <ul> <li>MANAGE CHANNEL to open a logical channel</li> <li>SELECT the given AID using the given p2</li> </ul>

Per Open Mobile API Specification v3.2 section 6.2.7.h, only p2 values of 0x00, 0x04, 0x08, and 0x0C are guaranteed to be supported.

If the SELECT command's status word is not '9000', '62xx', or '63xx', the status word will be considered an error and the channel shall not be opened.

Input parameters equivalent to TS 27.007 AT+CCHO command.

It is strongly recommended that callers of this should firstly create a new TelephonyManager instance by calling TelephonyManager#createForSubscriptionId(int). Failure to do so can result in unpredictable and detrimental behavior like callers can end up talking to the wrong SIM card.

Requires Permission: android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE or that the calling app has carrier privileges (see #hasCarrierPrivileges).

Java documentation for android.telephony.TelephonyManager.iccOpenLogicalChannel(java.lang.String, int).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.