1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
|
/*
** Copyright 2007, The Android Open Source Project
**
** Licensed under the Apache License, Version 2.0 (the "License");
** you may not use this file except in compliance with the License.
** You may obtain a copy of the License at
**
** http://www.apache.org/licenses/LICENSE-2.0
**
** Unless required by applicable law or agreed to in writing, software
** distributed under the License is distributed on an "AS IS" BASIS,
** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
** See the License for the specific language governing permissions and
** limitations under the License.
*/
package com.android.internal.telephony;
import android.content.ContentValues;
import com.android.internal.telephony.uicc.AdnRecord;
/** Interface for applications to access the ICC phone book.
*
* <p>The following code snippet demonstrates a static method to
* retrieve the IIccPhoneBook interface from Android:</p>
* <pre>private static IIccPhoneBook getSimPhoneBookInterface()
throws DeadObjectException {
IServiceManager sm = ServiceManagerNative.getDefault();
IIccPhoneBook spb;
spb = IIccPhoneBook.Stub.asInterface(sm.getService("iccphonebook"));
return spb;
}
* </pre>
*/
interface IIccPhoneBook {
/**
* Loads the AdnRecords in efid and returns them as a
* List of AdnRecords
*
* @param efid the EF id of a ADN-like SIM
* @return List of AdnRecord
*/
List<AdnRecord> getAdnRecordsInEf(int efid);
/**
* Loads the AdnRecords in efid and returns them as a
* List of AdnRecords
*
* @param efid the EF id of a ADN-like SIM
* @param subId user preferred subId
* @return List of AdnRecord
*/
List<AdnRecord> getAdnRecordsInEfForSubscriber(int subId, int efid);
/**
* 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
*
* @param efid must be one among EF_ADN, EF_FDN, and EF_SDN
* @param oldTag adn tag to be replaced
* @param oldPhoneNumber adn number to be replaced
* Set both oldTag and oldPhoneNubmer to "" means to replace an
* empty record, aka, insert new record
* @param newTag adn tag to be stored
* @param 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
* @param pin2 required to update EF_FDN, otherwise must be null
* @return true for success
*/
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
*
* @param efid must be one among EF_ADN, EF_FDN, and EF_SDN
* @param oldTag adn tag to be replaced
* @param oldPhoneNumber adn number to be replaced
* Set both oldTag and oldPhoneNubmer to "" means to replace an
* empty record, aka, insert new record
* @param newTag adn tag to be stored
* @param 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
* @param pin2 required to update EF_FDN, otherwise must be null
* @param subId user preferred subId
* @return true for success
*/
boolean updateAdnRecordsInEfBySearchForSubscriber(int subId, 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
*
* @param subId user preferred subId
* @param efid must be one among EF_ADN, EF_FDN, and EF_SDN
* @param values including ADN,EMAIL,ANR to be updated
* @param pin2 required to update EF_FDN, otherwise must be null
* @return true for success
*/
boolean updateAdnRecordsWithContentValuesInEfBySearchUsingSubId(int subId,
int efid, in ContentValues values, 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
*
* @param efid must be one among EF_ADN, EF_FDN, and EF_SDN
* @param newTag adn tag to be stored
* @param 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
* @param index is 1-based adn record index to be updated
* @param pin2 required to update EF_FDN, otherwise must be null
* @return true for success
*/
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
*
* @param efid must be one among EF_ADN, EF_FDN, and EF_SDN
* @param newTag adn tag to be stored
* @param 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
* @param index is 1-based adn record index to be updated
* @param pin2 required to update EF_FDN, otherwise must be null
* @param subId user preferred subId
* @return true for success
*/
boolean updateAdnRecordsInEfByIndexForSubscriber(int subId, int efid, String newTag,
String newPhoneNumber, int index,
String pin2);
/**
* Get the max munber of records in efid
*
* @param efid the EF id of a ADN-like SIM
* @return 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
*/
int[] getAdnRecordsSize(int efid);
/**
* Get the max munber of records in efid
*
* @param efid the EF id of a ADN-like SIM
* @param subId user preferred subId
* @return 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
*/
int[] getAdnRecordsSizeForSubscriber(int subId, int efid);
/**
* Get the adn count of sim card
*
* @return the adn count of sim card
*/
int getAdnCount();
/**
* Get the adn count of sim card
*
* @param subId user preferred subId
* @return the adn count of sim card
*/
int getAdnCountUsingSubId(int subId);
/**
* Get the anr count of sim card
*
* @return the anr count of sim card
*/
int getAnrCount();
/**
* Get the anr count of sim card
*
* @param subId user preferred subId
* @return the anr count of sim card
*/
int getAnrCountUsingSubId(int subId);
/**
* Get the email count of sim card
*
* @return the email count of sim card
*/
int getEmailCount();
/**
* Get the email count of sim card
*
* @param subId user preferred subId
* @return the email count of sim card
*/
int getEmailCountUsingSubId(int subId);
/**
* Get the spare anr count of sim card
*
* @return the spare anr count of sim card
*/
int getSpareAnrCount();
/**
* Get the spare anr count of sim card
*
* @param subId user preferred subId
* @return the spare anr count of sim card
*/
int getSpareAnrCountUsingSubId(int subId);
/**
* Get the spare email count of sim card
*
* @return the spare email count of sim card
*/
int getSpareEmailCount();
/**
* Get the spare email count of sim card
*
* @param subId user preferred subId
* @return the spare email count of sim card
*/
int getSpareEmailCountUsingSubId(int subId);
}
|
