com.android.internal.telephony.gsm
Interface ISimPhoneBook

All Superinterfaces:

IInterface

All Known Implementing Classes:

ISimPhoneBook.Stub

public interface ISimPhoneBook
extends IInterface

Interface for applications to access the SIM phone book.

The following code snippet demonstrates a static method to retrieve the ISimPhoneBook interface from Android:

private static ISimPhoneBook getSimPhoneBookInterface()
            throws DeadObjectException {
    IServiceManager sm = ServiceManagerNative.getDefault();
    ISimPhoneBook spb;
    spb = ISimPhoneBook.Stub.asInterface(sm.getService("simphonebook"));
    return spb;
}
 

Nested Class Summary

static class

ISimPhoneBook.Stub Local-side IPC implementation stub class.

Method Summary

List<com.android.internal.telephony.gsm.AdnRecord>	getAdnRecordsInEf(int efid) Loads the AdnRecords in efid and returns them as a List of AdnRecords
int[]	getAdnRecordsSize(int efid) Get the max munber of records in efid
boolean	updateAdnRecordsInEfByIndex(int efid, String newTag, String newPhoneNumber, int index, String pin2) Update an ADN-like EF record by record index This is useful for iteration the whole ADN file, such as write the whole phone book or erase/format the whole phonebook
boolean	updateAdnRecordsInEfBySearch(int efid, String oldTag, String oldPhoneNumber, String newTag, String newPhoneNumber, String pin2) Replace oldAdn with newAdn in ADN-like record in EF getAdnRecordsInEf must be called at least once before this function, otherwise an error will be returned

Methods inherited from interface android.os.IInterface

asBinder

Method Detail

getAdnRecordsInEf

List<com.android.internal.telephony.gsm.AdnRecord> getAdnRecordsInEf(int efid)
                                                                     throws RemoteException

Loads the AdnRecords in efid and returns them as a List of AdnRecords

Parameters:

efid - the EF id of a ADN-like SIM

Returns:

List of AdnRecord

Throws:

RemoteException

updateAdnRecordsInEfBySearch

boolean updateAdnRecordsInEfBySearch(int efid,
                                     String oldTag,
                                     String oldPhoneNumber,
                                     String newTag,
                                     String newPhoneNumber,
                                     String pin2)
                                     throws RemoteException

Replace oldAdn with newAdn in ADN-like record in EF getAdnRecordsInEf must be called at least once before this function, otherwise an error will be returned

Parameters:

efid - must be one among EF_ADN, EF_FDN, and EF_SDN

oldTag - adn tag to be replaced

oldPhoneNumber - adn number to be replaced Set both oldTag and oldPhoneNubmer to "" means to replace an empty record, aka, insert new record

newTag - adn tag to be stored

newPhoneNumber - adn number ot be stored Set both newTag and newPhoneNubmer to "" means to replace the old record with empty one, aka, delete old record

pin2 - required to update EF_FDN, otherwise must be null

Returns:

true for success

Throws:

RemoteException

updateAdnRecordsInEfByIndex

boolean updateAdnRecordsInEfByIndex(int efid,
                                    String newTag,
                                    String newPhoneNumber,
                                    int index,
                                    String pin2)
                                    throws RemoteException

Update an ADN-like EF record by record index This is useful for iteration the whole ADN file, such as write the whole phone book or erase/format the whole phonebook

Parameters:

efid - must be one among EF_ADN, EF_FDN, and EF_SDN

newTag - adn tag to be stored

newPhoneNumber - adn number to be stored Set both newTag and newPhoneNubmer to "" means to replace the old record with empty one, aka, delete old record

index - is 1-based adn record index to be updated

pin2 - required to update EF_FDN, otherwise must be null

Returns:

true for success

Throws:

RemoteException

getAdnRecordsSize

int[] getAdnRecordsSize(int efid)
                        throws RemoteException

Get the max munber of records in efid

Parameters:

efid - the EF id of a ADN-like SIM

Returns:

int[3] array recordSizes[0] is the single record length recordSizes[1] is the total length of the EF file recordSizes[2] is the number of records in the EF file

Throws:

RemoteException