net.rim.device.api.system
Class SIMCardInfo

java.lang.Object
  net.rim.device.api.system.SIMCardInfo

public final class SIMCardInfo
extends Object

Provides information about the SIM Card

Since:

BlackBerry API 4.1.0

Method Summary
static byte[]	getICCID() Retrieves the ICCID of the SIM Card.
static byte[]	getIMSI() Retrieves the International Mobile Subscriber Identity number.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getICCID

public static byte[] getICCID()
                       throws SIMCardException

Retrieves the ICCID of the SIM Card. Note: An application must be signed with an NFCR key to use this method. The BlackBerry device checks the NFCR signature at runtime. For more information about obtaining and applying an NFCR please contact your technical partnership manager at RIM.

Returns:

ICCID in binary coded decimal (BCD) format.

Throws:

ControlledAccessException - if PHONE_PERMISSION was not granted by the user or IT policy.

SIMCardException - if an error occurs while communicating with the SIM card.

Since:

BlackBerry API 7.1.0

getIMSI

public static byte[] getIMSI()
                      throws SIMCardException

Retrieves the International Mobile Subscriber Identity number.

Returns:

IMSI in BCD format

Throws:

ControlledAccessException - if the calling process does not have the necessary privileges

SIMCardException - if an error occurs

Since:

BlackBerry API 4.1.0