SOAP API Developer Guide

Introduction to SOAP API
Reference
Apex-Related Calls
Core Calls
convertLead()
create()
delete()
deleteByExample()
emptyRecycleBin()
executeListView()
findDuplicates()
findDuplicatesByIds()
getDeleted()
getUpdated()
invalidateSessions()
login()
logout()
merge()
performQuickActions()
process()
query()
AggregateResult
QueryLocator
QueryResult
queryAll()
queryMore()
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

QueryResult

A read-only SObject that contains query results and additional data about the query, returned in response to a query() or queryMore() call.

QueryResult only returns responses to queries that don't use an aggregate function, such as MAX(). For queries with an aggregate function, results are returned in AggregateResult.

The QueryResult object has these properties.

Name Type Description
queryLocator QueryLocator Points to a server-side cursor in the database. Tracks the current processing location in the query results set and indicates the location of additional results, A query locator is a specialized string, similar to an ID, and is 18 characters long and begins with the prefix 0r8. Used in queryMore() for retrieving subsequent sets of objects from the query results, if needed.
done boolean Indicates whether additional rows must be retrieved from the query results (false) using queryMore(), or not (true). Use this value as a loop condition while iterating through the query results.
records sObject[] Array of sObjects representing individual objects of the specified object and containing data defined in the field list specified in the queryString.
size int Total number of rows retrieved in the query. Use this value to determine whether the query retrieved any rows (size > 0) or not (size = 0). Querying external objects is supported, but an external data source doesn’t provide a count of the number of rows retrieved. When the number of rows retrieved from an external data source is unknown, the value is automatically set to size = -1.