2.2.3.9 CPMGetQueryStatusExOut
The CPMGetQueryStatusExOut message replies to a CPMGetQueryStatusExIn message with both the status of the query and other status information, as outlined in the following diagram.
The format of the CPMGetQueryStatusExOut message that follows the header is shown in the following diagram.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
_QStatus |
|||||||||||||||||||||||||||||||
|
_cFilteredDocuments |
|||||||||||||||||||||||||||||||
|
_cDocumentsToFilter |
|||||||||||||||||||||||||||||||
|
_dwRatioFinishedDenominator |
|||||||||||||||||||||||||||||||
|
_dwRatioFinishedNumerator |
|||||||||||||||||||||||||||||||
|
_iRowBmk |
|||||||||||||||||||||||||||||||
|
_cRowsTotal |
|||||||||||||||||||||||||||||||
|
_maxRank |
|||||||||||||||||||||||||||||||
|
_cResultsFound |
|||||||||||||||||||||||||||||||
|
_whereID |
|||||||||||||||||||||||||||||||
_QStatus (4 bytes): One of the STAT_* values specified in section 2.2.3.7.
_cFilteredDocuments (4 bytes): A 32-bit unsigned integer indicating the number of documents that have been indexed.
_cDocumentsToFilter (4 bytes): A 32-bit unsigned integer indicating the number of documents that remain to be indexed.
_dwRatioFinishedDenominator (4 bytes): A 32-bit unsigned integer indicating the denominator of the ratio of documents that the query has finished processing.
_dwRatioFinishedNumerator (4 bytes): A 32-bit unsigned integer indicating the numerator of the ratio of documents that the query has finished processing.
_iRowBmk (4 bytes): A 32-bit unsigned integer indicating the approximate position of the bookmark in the rowset in terms of rows.
_cRowsTotal (4 bytes): A 32-bit unsigned integer specifying the total number of rows in the rowset.
_maxRank (4 bytes): A 32-bit unsigned integer specifying the maximum rank found in the rowset.
_cResultsFound (4 bytes): A 32-bit unsigned integer specifying the number of unique results returned in the rowset.
_whereID (4 bytes): A 32-bit unsigned integer that defines a unique WHEREID for referring to the CRestrictionArray used to construct the rowset. This restriction can be reused as a restriction in future queries as long as there is still a cursor returned by CPMCreateQueryOut that has not been freed using CPMFreeCursorIn. This provides the server the option of sharing the evaluation of the restriction across queries.