QueryLocator

In the QueryResult object returned by the queryMore() call, queryLocator contains a value that you will use in the subsequent queryMore() call. Note the following guidelines for using this value:

• Use a queryLocator only once. When you pass it in a queryMore() call, the API returns a new queryLocator in the QueryResult.
• The queryLocator value expires automatically after 15 minutes of inactivity.
• A user can have up to ten query cursors open at a time. If ten QueryLocator cursors are opened when a client application with the same logged-in user attempts to open a new cursor, then the oldest of the ten cursors is released.

A QueryLocator represents a server-side cursor.

Note

A queryMore()call on a parent object invalidates all child cursors in the previous result set. If you need the results from the child, you must use queryMore() on those results before using queryMore() on the parent results.