android.telephony.gsm
public interface
public interface
android.telephony.gsm.ISimPhoneBook
| android.telephony.gsm.ISimPhoneBook | 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 Classes
| ISimPhoneBook.Stub | Local-side IPC implementation stub class. |
Known Indirect Subclasses
Summary
Public Methods
| List | 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
Details
Public Methods
public List getAdnRecordsInEf(int efid)
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
| DeadObjectException |
|---|
public int[] getAdnRecordsSize(int efid)
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
| DeadObjectException |
|---|
public 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
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
| DeadObjectException |
|---|
public 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
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
| DeadObjectException |
|---|