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.

C#
Copy
public class Sim
Inheritance
System.Object
Sim

Constructors

View Source

Sim(SlotHandle)

The SIM class constructor.

Declaration
C#
Copy
public Sim(SlotHandle handle)
Parameters
Type Name Description
SlotHandle handle

SlotHandle received in the Manager.Init API.

Exceptions
Type Condition
System.NotSupportedException

The required feature is not supported.

System.ArgumentNullException

This exception occurs if the handle provided is null.

API Level: 3
Feature: http://tizen.org/feature/network.telephony

Properties

View Source

ApplicationList

Gets the count of an application on the UICC.

Declaration
C#
Copy
public uint ApplicationList { get; }
Property Value
Type Description
System.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
View Source

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
C#
Copy
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
View Source

CurrentLockState

Gets the lock state of the SIM.

Declaration
C#
Copy
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
View Source

CurrentState

Gets the state of the SIM.

Declaration
C#
Copy
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
View Source

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
C#
Copy
public string GroupId1 { get; }
Property Value
Type Description
System.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
View Source

IccId

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

Declaration
C#
Copy
public string IccId { get; }
Property Value
Type Description
System.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
View Source

IsChanged

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

Declaration
C#
Copy
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
View Source

Msin

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

Declaration
C#
Copy
public string Msin { get; }
Property Value
Type Description
System.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
View Source

Operator

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

Declaration
C#
Copy
public string Operator { get; }
Property Value
Type Description
System.String

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

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/telephony
View Source

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
C#
Copy
public string Spn { get; }
Property Value
Type Description
System.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
View Source

SubscriberId

Gets the subscriber ID.

Declaration
C#
Copy
public string SubscriberId { get; }
Property Value
Type Description
System.String

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

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/telephony
View Source

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
C#
Copy
public string SubscriberNumber { get; }
Property Value
Type Description
System.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