3.2.5.1 Receiving a CPMCreateQueryOut Response

When the client receives a CPMCreateQueryOut message response from the server, the client MUST return back _status (and, if the status is successful, cursor handle values) to the higher layer. Any further actions are determined by the higher layer.

Because the higher layer is aware of query structure, it will always expect the correct number of cursor handles to be returned in the CPMCreateQueryOut message. The cursor handles are returned in the following order: The first handle is returned to the unchaptered rowset, and the second is returned to the first chaptered rowset (which is the grouping of results based on the first category specified in the CategorizationSet field of the CPMCreateQueryIn message).

For informative purposes, it is expected that higher layers can do the following actions, but these are not enforced by the Content Indexing Services Protocol client:

• Use CPMSetBindingsIn to set bindings for individual columns and to do any subsequent actions on the querypath.

• Use CPMGetQueryStatusIn to check on the execution progress of a query.

• Use CPMRatioFinishedIn to request the completion percentage of the query.