This Serviceis used to request the next set of QueryFirstor QueryNextresponse information that is too large to be sent in a single response. “Too large” in this context means that the Serveris not able to return a larger response or that the number of QueryDataSetsto return exceeds the maximum number of QueryDataSetsto return that was specified by the Clientin the original request. The QueryNextshall be submitted on the same session that was used to submit the QueryFirstor QueryNextthat is being continued.
Table 51defines the parameters for the Service.
Table 51– QueryNext Service Parameters
|
Name |
Type |
Description |
|
Request |
|
|
|
requestHeader |
Request Header |
Common request parameters (see 7.33for RequestHeaderdefinition). |
|
releaseContinuationPoint |
Boolean |
A Booleanparameter with the following values: TRUEpassed continuationPointshall be reset to free resources for the continuation point in the Server. FALSEpassed continuationPointshall be used to get the next set of QueryDataSets. A Clientshall always use the continuation point returned by a QueryFirstor QueryNextresponse to free the resources for the continuation point in the Server. If the Clientdoes not want to get the next set of Queryinformation, QueryNextshall be called with this parameter set to TRUE. If the parameter is set to TRUE all array parameters in the response shall contain empty arrays. |
|
continuationPoint |
ContinuationPoint |
Serverdefined opaque value that represents the continuation point. The value of the continuation point was returned to the Clientin a previous QueryFirstor QueryNextresponse. This value is used to identify the previously processed QueryFirstor QueryNextrequest that is being continued, and the point in the result set from which the browse response is to continue. The ContinuationPointtype is described in 7.9. |
|
|
|
|
|
Response |
|
|
|
responseHeader |
Response Header |
Common response parameters (see 7.34for ResponseHeaderdefinition). |
|
queryDataSets [] |
QueryDataSet |
The array of QueryDataSets. The QueryDataSettype is defined in 7.28. |
|
revisedContinuationPoint |
ContinuationPoint |
Server-defined opaque value that represents the continuation point. It is used only if the information to be returned is too large to be contained in a single response. When not used or when releaseContinuationPointis set, the value of this parameter is null or empty. The ContinuationPointtype is described in 7.9. |
Table 52defines the Serviceresults specific to this Service. Common StatusCodesare defined in Table 182.
Table 52– QueryNext Service Result Codes
|
Symbolic Id |
Description |
|
Bad_ContinuationPointInvalid |
See Table 183for the description of this result code. |