Class Sim

Definition

Namespace:

Tizen.Telephony

Assembly:

Tizen.Telephony.dll

API Level:

3

This class provides APIs that allow you to extract the information stored on a SIM card.

public class Sim

Inheritance

Object

Sim

Constructors

Sim(SlotHandle)

The SIM class constructor.

Declaration

public Sim(SlotHandle handle)

Parameters

Type	Name	Description
SlotHandle	handle	SlotHandle received in the Manager.Init API.

Exceptions

Type	Condition
NotSupportedException	The required feature is not supported.
ArgumentNullException	This exception occurs if the handle provided is null.

API Level: 3

Feature: http://tizen.org/feature/network.telephony

Properties

ApplicationList

Gets the count of an application on the UICC.

Declaration

public uint ApplicationList { get; }

Property Value

Type	Description
UInt32	The masking value for below values are provided by the enumeration ApplicationType. 0 if unable to complete the operation.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/telephony

CallForwardingIndicatorState

Gets the call forwarding indicator state of the SIM. If the state is true, the incoming call will be forwarded to the selected number. State indicates the CFU (Call Forwarding Unconditional) indicator status - Voice (3GPP TS 31.102 4.2.64 EF CFIS).

Declaration

public bool CallForwardingIndicatorState { get; }

Property Value

Type	Description
Boolean	The value whether the incoming call will be forwarded or not (true: forwarded, false: not forwarded).

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/telephony

CurrentLockState

Gets the lock state of the SIM.

Declaration

public Sim.LockState CurrentLockState { get; }

Property Value

Type	Description
Sim.LockState	The current lock state of the SIM.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/telephony

CurrentState

Gets the state of the SIM.

Declaration

public Sim.State CurrentState { get; }

Property Value

Type	Description
Sim.State	The current state of the SIM.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/telephony

GroupId1

Gets the GID1 (Group Identifier Level 1). Gets Group Identifier Level 1 (GID1) embedded in the SIM card. If this value is not stored in SIM card, an empty string will be returned.

Declaration

public string GroupId1 { get; }

Property Value

Type	Description
String	The GID1 (Group Identifier Level 1). Empty string if unable to complete the operation.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/telephony

IccId

Gets the Integrated Circuit Card IDentification (ICC-ID). The Integrated Circuit Card Identification number internationally identifies SIM cards.

Declaration

public string IccId { get; }

Property Value

Type	Description
String	The Integrated Circuit Card Identification. Empty string if unable to complete the operation.

Remarks

To avoid the unexpected behavior of old version applications that have http://tizen.org/privilege/telephony privilege. There is an exceptional handling in case of permission denied. For an application with API version 6 or higher, if an application doesn't have http://tizen.org/privilege/securesysteminfo privilege, it sets with empty string. For an application with API version lower than 6. if an application has http://tizen.org/privilege/telephony privilege, it sets with a pseudo value.

API Level: 3

Privilege Level: partner

Privilege: http://tizen.org/privilege/securesysteminfo

IsChanged

Checks whether the current SIM card is different from the previous SIM card.

Declaration

public bool IsChanged { get; }

Property Value

Type	Description
Boolean	true if the current SIM card is different from the previous SIM card, otherwise false if the SIM card is not changed.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/telephony

Msin

Gets the Mobile Subscription Identification Number (MSIN [9~10 digits]) of the SIM provider.

Declaration

public string Msin { get; }

Property Value

Type	Description
String	The Mobile Subscription Identification Number. Empty string if unable to complete the operation.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/telephony

Operator

Gets the SIM Operator (MCC [3 digits] + MNC [2~3 digits]). The Operator is embedded in the SIM card.

Declaration

public string Operator { get; }

Property Value

Type	Description
String	The SIM Operator. Empty string if unable to complete the operation.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/telephony

Spn

Gets the Service Provider Name (SPN) of the SIM card. Gets Service Provider Name embedded in the SIM card. If this value is not stored in the SIM card, an empty string will be returned.

Declaration

public string Spn { get; }

Property Value

Type	Description
String	The Service Provider Name. Empty string if unable to complete the operation.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/telephony

SubscriberId

Gets the subscriber ID.

Declaration

public string SubscriberId { get; }

Property Value

Type	Description
String	The subscriber ID. Empty string if unable to complete the operation.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/telephony

SubscriberNumber

Gets the subscriber number embedded in the SIM card. This value contains the MSISDN related to the subscriber. If this value is not stored in SIM card, an empty string will be returned.

Declaration

public string SubscriberNumber { get; }

Property Value

Type	Description
String	The subscriber number in the SIM. Empty string if unable to complete the operation.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/telephony