2.4.343 BrtCsProtectionIso

The BrtCsProtectionIso record specifies protection options for a chart sheet in a manner compatible with ISO/IEC 29500 chart sheet protection records as specified in [ISO/IEC29500-1:2016], section 18.3.1.84. A BrtCsProtectionIso record MUST be immediately followed by a BrtCsProtection record (section 2.4.342) whose protpwd field MUST be set to 0x0000 and whose fLocked and fObjects fields MUST have the same values as the fields of the same names in the BrtCsProtectionIso record.


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

dwSpinCount

fLocked

fObjects

ipdPasswordData (variable)

...

dwSpinCount (4 bytes): An unsigned 32-bit integer that specifies the number of times that the hash function was iterated over the password to generate the rgbHash field of ipdPasswordData, as described in section 2.2.10. This value MUST NOT be greater than 10,000,000.

fLocked (4 bytes):  A Boolean (section 2.5.98.3) that specifies whether changes can be made to elements of the chart in the chart sheet. The chart will continue to reflect changes in source data (section 2.2.5.2.1). This value MUST have the same value as the fLocked field in the following BrtCsProtection record (section 2.4.342), and MUST be a value from the following table.

Value

Meaning

0x00000000

Changes to the chart elements are not prevented.

0x00000001

Changes to the chart elements are prevented.

fObjects (4 bytes):  A Boolean (section 2.5.98.3) that specifies whether changes can be made to graphic objects (such as shapes, text boxes, and controls) in the chart sheet. This value MUST have the same value as the fObjects field in the following BrtCsProtection record (section 2.4.342), and MUST be a value from the following table.

Value

Meaning

0x00000000

Changes to the graphic objects are not prevented.

0x00000001

Changes to the graphic objects are prevented.

ipdPasswordData (variable): An IsoPasswordData (section 2.5.80) that specifies the salt, hash algorithm and password hash of the password required for editing the chart sheet, calculated using the Strong Password Verifier Algorithm (section 2.2.10). The size of the rgbHash member of this field MUST NOT be zero.