Build 1.0_r1(from source)

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

Build 1.0_r1(from source)

Please submit a feedback, bug or feature