282 |
282 |
283 /** |
283 /** |
284 * Starts a query operation and returns immediately. The observers of |
284 * Starts a query operation and returns immediately. The observers of |
285 * the query instance will be notified when the query is completed, or |
285 * the query instance will be notified when the query is completed, or |
286 * if it fails. The query parameters (order rules, search conditions, |
286 * if it fails. The query parameters (order rules, search conditions, |
287 * property filters) must be configured before FindL() is called. FindL() |
287 * property filters) must be configured before FindL() is called. |
288 * may be called several times, but the query parameters that were in |
|
289 * effect for the first FindL() are used for all subsequent calls. Any |
|
290 * previously fetched query results remain in the query instance's |
|
291 * list of result items; any new result items are appended to the end of |
|
292 * the list. |
|
293 * |
288 * |
294 * The caller can perform a find operation in several steps by using a |
289 * The caller can perform a find operation in several steps by using a |
295 * sufficiently small maximum number of result items. Subsequent calls to |
290 * sufficiently small maximum number of result items. Notifications |
296 * FindL() work incrementally, continuing the previously started find |
291 * about progress of query is returned is steps, continuing the previously |
297 * operation. |
292 * started find operation. |
298 * |
293 * |
299 * @param aMaxCount Maximum number of result items. Defaults to |
294 * @param aMaxCount Maximum number of result items. Defaults to |
300 * unlimited. |
295 * unlimited. |
301 * @param aNotifyCount Maximum number of results per observer |
296 * @param aNotifyCount Maximum number of results per observer |
302 * notification. Defaults to unlimited. |
297 * notification. Defaults to unlimited. |