SOAP API Developer Guide

Getting Started
Reference
Data Model
Standard Objects
Core Calls
convertLead()
create()
delete()
emptyRecycleBin()
executeListView()
findDuplicates()
getDeleted()
getUpdated()
invalidateSessions()
login()
logout()
merge()
performQuickActions()
process()
query()
queryAll()
queryMore()
QueryResult
QueryLocator
retrieve()
search()
undelete()
update()
upsert()
Describe Calls
Utility Calls
SOAP Headers
Using the API with Salesforce Features
Glossary
PDF

Newer Version Available

This content describes an older version of this product. View Latest

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.
  • You can't use a custom metadata query as a queryLocator.

A QueryLocator represents a server-side cursor.

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.

Note