2.2.1.15 CRowsetProperties

The CRowsetProperties structure contains configuration information for a search query.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

_uBooleanOptions

_ulMaxOpenRows

_ulMemoryUsage

_cMaxResults

_cCmdTimeout

_dwQueryID (optional)

_uBooleanOptions (4 bytes): This field specifies various query Boolean options.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

A

B

C

D

E

F

G

H

I

J

K

L

M

N

O

P

Q

R

S

T

U

V

W

X

Y

Z

A A

A B

A C

A D

A E

A F

A - U0: MUST be set to 1 and MUST be ignored.

B through O - U1, U2, A1, A2, U3, U4, U5, U6, U7, U8, U9, U10, U11, U12: MUST be set to 0 and MUST be ignored.

P - IN: Specifies the desired noise word behavior. Its value MUST be 1 if the noise words are ignored, and 0 otherwise.

Q through U - U13, U14, U15, U16, U17: MUST be set to 0 and MUST be ignored.

V - AT: Specifies the desired token inclusion behavior that MUST be used by the server unless the inclusion behavior is specified explicitly by keyword syntax as specified in [MS-SEARCH] section 2.2.11.8. If the value is 0, the server MUST return only the search results containing all of the tokens in the query. Otherwise, the server MUST return search results that contain any of the tokens.

W - ES: Specifies the desired stemming query expansion behavior. If the value is 1, the server MUST use stemming query expansion. If the value is 0, the server MUST NOT use stemming query expansion.

X through AF - EP, EN, IT, U18, U19, U20, U21, U22, U23: MUST be set to 0 and MUST be ignored.

_ulMaxOpenRows (4 bytes): A 32-bit unsigned integer. MUST be set to 0x00000000. Not used, and MUST be ignored.

_ulMemoryUsage (4 bytes): A 32-bit unsigned integer. MUST be set to 0x00000000. 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 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, counting from the time the query starts executing on the server. On a timeout, the query is interrupted and terminated, and the server continues to communicate with the client using the regular sequence of messages. A value of 0x00000000 means that the query is not to time out.

_dwQueryID (4 bytes): A 32-bit unsigned integer that identifies the query for debugging purposes. This field MUST only be present if both protocol client and protocol server are capable of handling _dwQueryID value as indicated by the _iClientVersion field in the CPMConnectIn message and the _serverVersion field in the CPMConnectOut message. The value of this field can be any arbitrary value. The protocol server SHOULD use this value in any logging related to the query being executed (if any).