2.2.3.8 CPMFetchValueIn
The CPMFetchValueIn message requests metadata about the most recent search query initiated with a CPMCreateQueryIn message.
The format of the CPMFetchValueIn message that follows the header is shown in the following diagram.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
_wid |
|||||||||||||||||||||||||||||||
|
_cbSoFar |
|||||||||||||||||||||||||||||||
|
_cbPropSpec |
|||||||||||||||||||||||||||||||
|
_cbChunk |
|||||||||||||||||||||||||||||||
|
PropSpec (variable) |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
_padding (variable) |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
_wid (4 bytes): A 32-bit reserved field. MUST be set to "0xFFFFFFFF".
_cbSoFar (4 bytes): A 32-bit unsigned integer containing the number of bytes previously transferred for this property. This field MUST be set to "0x00000000" in the first message.
_cbPropSpec (4 bytes): A 32-bit unsigned integer containing the size of the PropSpec field in bytes.
_cbChunk (4 bytes): A 32-bit unsigned integer containing the maximum number of bytes that the sender can accept in a CPMFetchValueOut message. The value of this field MUST be greater than 0x0000001C.
PropSpec (variable): A CFullPropSpec structure specifying the property to retrieve. If _cbPropSpec is not "0", the following field values MUST be set on this structure. Otherwise, this structure MUST be omitted. Valid values are listed in the following table.
|
Field |
Value |
|---|---|
|
_guidPropSet |
E83758B4-0C6E-435B-BCC6-268021EFAD6C |
|
ulKind |
PRSPEC_PROPID (0x00000001) |
|
PrSpec |
0x00000000 |
_padding (variable): This field MUST be zero to 3 bytes long to pad the message to a multiple of 4 bytes in length. The value of the padding bytes can be any arbitrary value. This field MUST be ignored by the receiver.