2.1.6.1 DataSpaceMapEntry Structure

The DataSpaceMapEntry structure associates protected content with a specific data space definition. It is contained within the DataSpaceMap structure (section 2.1.6).

Reference components MUST be listed from the most general—that is, storages—to the most specific—that is, streams (1). For example, a stream (1) titled "Chapter 1" in a substorage called "Book" off the root storage of an OLE compound file would have two reference components: "Book" and "Chapter 1", in that order. The simplest content stream (1) reference is one with a single reference component indicating the name of a stream (1) in the root storage of the OLE compound file.


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

Length

ReferenceComponentCount

ReferenceComponents (variable)

...

DataSpaceName (variable)

...

Length (4 bytes): An unsigned integer that specifies the size, in bytes, of the DataSpaceMapEntry structure.

ReferenceComponentCount (4 bytes): An unsigned integer that specifies the number of DataSpaceReferenceComponent items (section 2.1.6.2) in the ReferenceComponents array.

ReferenceComponents (variable): An array of one or more DataSpaceReferenceComponent structures. Each DataSpaceReferenceComponent structure specifies the name of a storage or stream (1) containing protected content that is associated with the data space definition named in the DataSpaceName field.

DataSpaceName (variable): A UNICODE-LP-P4 structure (section 2.1.2) that specifies the name of the data space definition associated with the protected content specified in the ReferenceComponents field. It MUST be equal to the name of a stream (1) in the \0x06DataSpaces\DataSpaceInfo storage as specified in section 2.2.2.