2.4.214 RealTimeData

The RealTimeData record specifies the real-time data (RTD) information for a workbook.

There is one RealTimeData record for each RTD topic in the workbook.


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

frtHeader

...

...

ichSamePrefix

stTopic (variable)

...

rtdOper (variable)

...

rgRTDE (variable)

...

frtHeader (12 bytes): An FrtHeader structure. The frtHeader.rt field MUST be 0x0813.

ichSamePrefix (4 bytes):  An unsigned integer that specifies the number of leading characters in common with the stTopic string in the previous RealTimeData record. MUST be 0 if there is no prefix in common or if this is the first RealTimeData record.

stTopic (variable):  An XLUnicodeStringSegmentedRTD structure that specifies the string for the RTD topic specified by this record. The string can be stored in a compressed or uncompressed format. When ichSamePrefix is greater than 0, this string does not include any leading characters that are in common with the stTopic string in the previous RealTimeData record. The first substring specifies the ProgID of the RTD server. The second substring specifies the server name that the RTD server is running on or, if this substring is empty, specifies that the RTD server is running locally. The rest of the substrings are combined to form a unique RTD topic.

rtdOper (variable):  An RTDOper structure that specifies the data returned by the RTD server.

rgRTDE (variable): An array of RTDEItem structures that specifies the set of cells associated with the RTD topic. The length of the array is specified by the following formula:

Array length = (size of this record and associated ContinueFrt records - 16 - size of stTopic – size of rtdOper)  / 6