2.2.1.22 CRowsetProperties
The CRowsetProperties structure contains configuration information for a query.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
_uBooleanOptions |
|||||||||||||||||||||||||||||||
_ulMaxOpenRows |
|||||||||||||||||||||||||||||||
_ulMemoryUsage |
|||||||||||||||||||||||||||||||
_cMaxResults |
|||||||||||||||||||||||||||||||
_cCmdTimeout |
_uBooleanOptions (4 bytes): The least significant 3 bits of this field MUST contain one of the following three values.
-
Value
Meaning
eSequential
0x00000001
The cursor (1) can be moved only forward.
eLocatable
0x00000003
The cursor can be moved to any position.
eScrollable
0x00000007
The cursor can be moved to any position and fetch in any direction.
-
The remaining bits MAY either be clear or set to any combination of the following values by using the bitwise OR operation.
-
Value
Meaning
eAsynchronous
0x00000008
The client will not wait for execution completion.
eFirstRows
0x00000080
Return the first rows encountered, not the best matches.
eHoldRows
0x00000200
The server MUST NOT discard rows until the client is done with a query.
eChaptered
0x00000800
The rowset supports chapters.
eUseCI
0x00001000
Use the inverted index to evaluate content restrictions even though it can be out of date. If not set, the indexing service can opt to execute the query by going directly against the file system.
eDeferTrimming
0x00002000
Nonindexed trimming operations, like scoping or security checking, can be expensive. This option gives the indexing service the option of deferring these operations until rows are actually requested.
_ulMaxOpenRows (4 bytes): A 32-bit unsigned integer. MUST be set to 0x00000000. It is not used and MUST be ignored.
_ulMemoryUsage (4 bytes): A 32-bit unsigned integer. MUST be set to 0x00000000. It is not used and MUST be ignored.
_cMaxResults (4 bytes): A 32-bit unsigned integer, specifying the maximum number of rows that are to be returned for the query. If _cMaxResults is set to 0x00000000, then the server assumes all results are requested and behaves as if 0xFFFFFFFF was specified in _cMaxResults.
_cCmdTimeout (4 bytes): A 32-bit unsigned integer, specifying the number of seconds at which a query is to time out and automatically terminate, counting from the time the query starts executing on the server. A value of 0x00000000 means that the query is not to time out.