2.4.771 BrtRRHeader

The BrtRRHeader record specifies metadata about a list of revisions that have been made in shared workbook (section 2.2.12).


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

rrd (14 bytes)

...

...

...

guid (16 bytes)

...

...

...

sdtr

...

...

tabidMac

revidMin

revidMax

stUser (variable)

...

szRelId (variable)

...

ctabid

rgtabid (variable)

...

crevid

rgrevid (variable)

...

rrd (14 bytes): An RRd (section 2.5.124) that specifies shared revision data. rrd has the following additional stipulations:

Field

Restrictions

rrd.unused1

MUST be 0xFFFFFFFF.

rrd.revt

MUST be 0x0020 (REVTHEADER). See section 2.5.117 for definition.

rrd.tabid

MUST be 0xFFFF.

Additionally, all fields of rrd other than those specified in the preceding table MUST be 0 and all fields of rrd other than revt MUST be ignored.

guid (16 bytes):  A GUID as specified by [MS-DTYP] section 2.3.4 that specifies this set of revisions.

sdtr (8 bytes): A ShortDtr (section 2.5.133) that specifies the date and time when this set of revisions was saved.

tabidMac (2 bytes): An unsigned integer that specifies the next unused sheet identifier when this set of revisions was saved. A sheet identifier corresponds to the iTabID field of a BrtBundleSh (section 2.4.313) record as specified by the Workbook (section 2.1.7.61) part ABNF. A value of 0xFFFF indicates that the next unused sheet identifier is not known.

revidMin (4 bytes): An unsigned integer that specifies the lowest revision identifier which is associated with this header. A revision identifier is the rrd.revid field of records which begin with an RRd (section 2.5.124). This value MUST be 0 if no reviewable revisions are associated with this header; otherwise MUST be greater than 0. A reviewable revision is any record on the revision log (section 2.2.12.3) that has the field revid of RRd greater than 0. MUST be less than 0xFFFFFFFF.

revidMax (4 bytes): An unsigned integer that specifies the highest revision identifier which is associated with this header. A revision identifier is the rrd.revid field of records which begin with an RRd (section 2.5.124). This value MUST be 0 if no reviewable revisions are associated with this header; otherwise MUST be greater than 0. A reviewable revision is any record on the revision log (section 2.2.12.3) that has the field revid of RRd (section 2.5.124) greater than 0. MUST be greater than or equal to the value of revidMin.

stUser (variable): An XLWideString (section 2.5.169) that specifies the name of the user responsible for this set of revisions. The length of this string MUST be greater than or equal to 1 and less than or equal to 54.

szRelId (variable): An XLWideString that specifies the relationship identifier of this set of revisions. A relationship identifier corresponds to RevisionHeaders.bin.rels. This string MUST NOT be null or empty.

ctabid (4 bytes): An unsigned integer that specifies the number of sheets present in the workbook when this set of revisions was saved. MUST be greater than 0 and MUST be less than 65536.

rgtabid (variable):  An array of 2-byte unsigned integers that specifies sheet identifiers, which specify the display order of the sheets when this set of revisions was saved. A sheet identifier corresponds to the iTabID field of a BrtBundleSh (section 2.4.313) record as specified by the Workbook (section 2.1.7.61) part ABNF . MUST have length equal to ctabid. Elements of this array MUST NOT appear more than once and MUST have a value equal to the iTabID field of one of the BrtBundleSh records for the workbook.

crevid (4 bytes):  An unsigned integer that specifies the number of revisions associated with this header that have been reviewed. If either revidMin or revidMax are 0, this value MUST be 0; otherwise it MUST be no greater than the value revidMax - revidMin + 1.

rgrevid (variable):  An array of 32-bit unsigned integers that specifies the revision identifiers associated with this header that have been reviewed. A revision identifier is the rrd.revid field of records which begin with an RRd (section 2.5.124). The length of this array MUST be crevid. The elements of this array MUST NOT appear more than once, each element MUST have a value greater than or equal to revidMin, and each element MUST have a value less than or equal to revidMax.