FileDocCategorySizeDatePackage
IccCard.javaAPI DocAndroid 5.1 API8196Thu Mar 12 22:22:54 GMT 2015com.android.internal.telephony

IccCard

public interface IccCard
{@hide}
Deprecated
use UiccController.getUiccCard instead. Integrated Circuit Card (ICC) interface An object of a class implementing this interface is used by external apps (specifically PhoneApp) to perform icc card related functionality. Apps (those that have access to Phone object) can retrieve this object by calling phone.getIccCard() This interface is implemented by IccCardProxy and the object PhoneApp gets when it calls getIccCard is IccCardProxy.

Fields Summary
Constructors Summary
Methods Summary
public voidchangeIccFdnPassword(java.lang.String oldPassword, java.lang.String newPassword, android.os.Message onComplete)
Change the ICC password used in ICC fdn enable When the operation is complete, onComplete will be sent to its handler

param
oldPassword is the old password
param
newPassword is the new password
param
onComplete onComplete.obj will be an AsyncResult ((AsyncResult)onComplete.obj).exception == null on success ((AsyncResult)onComplete.obj).exception != null on fail

public voidchangeIccLockPassword(java.lang.String oldPassword, java.lang.String newPassword, android.os.Message onComplete)
Change the ICC password used in ICC pin lock When the operation is complete, onComplete will be sent to its handler

param
oldPassword is the old password
param
newPassword is the new password
param
onComplete onComplete.obj will be an AsyncResult ((AsyncResult)onComplete.obj).exception == null on success ((AsyncResult)onComplete.obj).exception != null on fail

public booleangetIccFdnAvailable()
Check whether fdn (fixed dialing number) service is available.

return
true if ICC fdn service available false if ICC fdn service not available

public booleangetIccFdnEnabled()
Check whether ICC fdn (fixed dialing number) is enabled This is a sync call which returns the cached pin enabled state

return
true for ICC fdn enabled false for ICC fdn disabled

public com.android.internal.telephony.uicc.IccFileHandlergetIccFileHandler()

return
IccFileHandler object belonging to current UiccCardApplication

public booleangetIccLockEnabled()
Check whether ICC pin lock is enabled This is a sync call which returns the cached pin enabled state

return
true for ICC locked enabled false for ICC locked disabled

public booleangetIccPin2Blocked()

return
true if ICC card is PIN2 blocked

public booleangetIccPuk2Blocked()

return
true if ICC card is PUK2 blocked

public com.android.internal.telephony.uicc.IccRecordsgetIccRecords()

return
IccRecords object belonging to current UiccCardApplication

public java.lang.StringgetServiceProviderName()
Returns service provider name stored in ICC card. If there is no service provider name associated or the record is not yet available, null will be returned

Please use this value when display Service Provider Name in idle mode

Usage of this provider name in the UI is a common carrier requirement. Also available via Android property "gsm.sim.operator.alpha"

return
Service Provider Name stored in ICC card null if no service provider name associated or the record is not yet available

public com.android.internal.telephony.IccCardConstants.StategetState()

return
combined Card and current App state

public booleanhasIccCard()

return
true if a ICC card is present

public booleanisApplicationOnIcc(IccCardApplicationStatus.AppType type)
Checks if an Application of specified type present on the card

param
type is AppType to look for

public voidregisterForAbsent(android.os.Handler h, int what, java.lang.Object obj)
Notifies handler of any transition into IccCardConstants.State.ABSENT

public voidregisterForLocked(android.os.Handler h, int what, java.lang.Object obj)
Notifies handler of any transition into IccCardConstants.State.isPinLocked()

public voidregisterForNetworkLocked(android.os.Handler h, int what, java.lang.Object obj)
Notifies handler of any transition into IccCardConstants.State.NETWORK_LOCKED

public voidsetIccFdnEnabled(boolean enabled, java.lang.String password, android.os.Message onComplete)
Set the ICC fdn enabled or disabled When the operation is complete, onComplete will be sent to its handler

param
enabled "true" for locked "false" for unlocked.
param
password needed to change the ICC fdn enable, aka Pin2
param
onComplete onComplete.obj will be an AsyncResult ((AsyncResult)onComplete.obj).exception == null on success ((AsyncResult)onComplete.obj).exception != null on fail

public voidsetIccLockEnabled(boolean enabled, java.lang.String password, android.os.Message onComplete)
Set the ICC pin lock enabled or disabled When the operation is complete, onComplete will be sent to its handler

param
enabled "true" for locked "false" for unlocked.
param
password needed to change the ICC pin state, aka. Pin1
param
onComplete onComplete.obj will be an AsyncResult ((AsyncResult)onComplete.obj).exception == null on success ((AsyncResult)onComplete.obj).exception != null on fail

public voidsupplyNetworkDepersonalization(java.lang.String pin, android.os.Message onComplete)
Supply Network depersonalization code to the RIL

public voidsupplyPin(java.lang.String pin, android.os.Message onComplete)
Supply the ICC PIN to the ICC When the operation is complete, onComplete will be sent to its Handler. onComplete.obj will be an AsyncResult ((AsyncResult)onComplete.obj).exception == null on success ((AsyncResult)onComplete.obj).exception != null on fail If the supplied PIN is incorrect: ((AsyncResult)onComplete.obj).exception != null && ((AsyncResult)onComplete.obj).exception instanceof com.android.internal.telephony.gsm.CommandException) && ((CommandException)(((AsyncResult)onComplete.obj).exception)) .getCommandError() == CommandException.Error.PASSWORD_INCORRECT

public voidsupplyPin2(java.lang.String pin2, android.os.Message onComplete)
Supply the ICC PIN2 to the ICC

public voidsupplyPuk(java.lang.String puk, java.lang.String newPin, android.os.Message onComplete)
Supply the ICC PUK to the ICC

public voidsupplyPuk2(java.lang.String puk2, java.lang.String newPin2, android.os.Message onComplete)
Supply the ICC PUK2 to the ICC

public voidunregisterForAbsent(android.os.Handler h)

public voidunregisterForLocked(android.os.Handler h)

public voidunregisterForNetworkLocked(android.os.Handler h)