**\[MS-OLEPS\]:** **Object Linking and Embedding (OLE) Property Set Data Structures** Intellectual Property Rights Notice for Open Specifications Documentation - **Technical Documentation.** Microsoft publishes Open Specifications documentation (“this documentation”) for protocols, file formats, data portability, computer languages, and standards support. Additionally, overview documents cover inter-protocol relationships and interactions. - **Copyrights**. This documentation is covered by Microsoft copyrights. Regardless of any other terms that are contained in the terms of use for the Microsoft website that hosts this documentation, you can make copies of it in order to develop implementations of the technologies that are described in this documentation and can distribute portions of it in your implementations that use these technologies or in your documentation as necessary to properly document the implementation. You can also distribute in your implementation, with or without modification, any schemas, IDLs, or code samples that are included in the documentation. This permission also applies to any documents that are referenced in the Open Specifications documentation. - **No Trade Secrets**. Microsoft does not claim any trade secret rights in this documentation. - **Patents**. Microsoft has patents that might cover your implementations of the technologies described in the Open Specifications documentation. Neither this notice nor Microsoft's delivery of this documentation grants any licenses under those patents or any other Microsoft patents. However, a given Open Specifications document might be covered by the Microsoft [Open Specifications Promise](https://go.microsoft.com/fwlink/?LinkId=214445) or the [Microsoft Community Promise](https://go.microsoft.com/fwlink/?LinkId=214448). If you would prefer a written license, or if the technologies described in this documentation are not covered by the Open Specifications Promise or Community Promise, as applicable, patent licenses are available by contacting . - **License Programs**. To see all of the protocols in scope under a specific license program and the associated patents, visit the [Patent Map](https://aka.ms/AA9ufj8). - **Trademarks**. The names of companies and products contained in this documentation might be covered by trademarks or similar intellectual property rights. This notice does not grant any licenses under those rights. For a list of Microsoft trademarks, visit [www.microsoft.com/trademarks](https://www.microsoft.com/trademarks). - **Fictitious Names**. The example companies, organizations, products, domain names, email addresses, logos, people, places, and events that are depicted in this documentation are fictitious. No association with any real company, organization, product, domain name, email address, logo, person, place, or event is intended or should be inferred. **Reservation of Rights**. All other rights are reserved, and this notice does not grant any rights other than as specifically described above, whether by implication, estoppel, or otherwise. **Tools**. The Open Specifications documentation does not require the use of Microsoft programming tools or programming environments in order for you to develop an implementation. If you have access to Microsoft programming tools and environments, you are free to take advantage of them. Certain Open Specifications documents are intended for use in conjunction with publicly available standards specifications and network programming art and, as such, assume that the reader either is familiar with the aforementioned material or has immediate access to it. **Support.** For questions and support, please contact . **Revision Summary** | Date | Revision History | Revision Class | Comments | |----|----|----|----| | 4/8/2008 | 0.1 | New | Version 0.1 release | | 6/20/2008 | 0.1.1 | Editorial | Changed language and formatting in the technical content. | | 7/25/2008 | 0.1.2 | Editorial | Changed language and formatting in the technical content. | | 8/29/2008 | 0.1.3 | Editorial | Changed language and formatting in the technical content. | | 10/24/2008 | 0.1.4 | Editorial | Changed language and formatting in the technical content. | | 12/5/2008 | 0.2 | Minor | Clarified the meaning of the technical content. | | 1/16/2009 | 0.2.1 | Editorial | Changed language and formatting in the technical content. | | 2/27/2009 | 0.2.2 | Editorial | Changed language and formatting in the technical content. | | 4/10/2009 | 0.2.3 | Editorial | Changed language and formatting in the technical content. | | 5/22/2009 | 0.2.4 | Editorial | Changed language and formatting in the technical content. | | 7/2/2009 | 1.0 | Major | Updated and revised the technical content. | | 8/14/2009 | 1.0.1 | Editorial | Changed language and formatting in the technical content. | | 9/25/2009 | 1.1 | Minor | Clarified the meaning of the technical content. | | 11/6/2009 | 1.1.1 | Editorial | Changed language and formatting in the technical content. | | 12/18/2009 | 2.0 | Major | Updated and revised the technical content. | | 1/29/2010 | 3.0 | Major | Updated and revised the technical content. | | 3/12/2010 | 3.0.1 | Editorial | Changed language and formatting in the technical content. | | 4/23/2010 | 3.0.2 | Editorial | Changed language and formatting in the technical content. | | 6/4/2010 | 3.0.3 | Editorial | Changed language and formatting in the technical content. | | 7/16/2010 | 3.0.3 | None | No changes to the meaning, language, or formatting of the technical content. | | 8/27/2010 | 3.0.3 | None | No changes to the meaning, language, or formatting of the technical content. | | 10/8/2010 | 3.0.3 | None | No changes to the meaning, language, or formatting of the technical content. | | 11/19/2010 | 3.0.3 | None | No changes to the meaning, language, or formatting of the technical content. | | 1/7/2011 | 3.0.3 | None | No changes to the meaning, language, or formatting of the technical content. | | 2/11/2011 | 3.0.3 | None | No changes to the meaning, language, or formatting of the technical content. | | 3/25/2011 | 3.0.3 | None | No changes to the meaning, language, or formatting of the technical content. | | 5/6/2011 | 3.0.3 | None | No changes to the meaning, language, or formatting of the technical content. | | 6/17/2011 | 3.1 | Minor | Clarified the meaning of the technical content. | | 9/23/2011 | 3.1 | None | No changes to the meaning, language, or formatting of the technical content. | | 12/16/2011 | 3.1 | None | No changes to the meaning, language, or formatting of the technical content. | | 3/30/2012 | 3.1 | None | No changes to the meaning, language, or formatting of the technical content. | | 7/12/2012 | 3.1 | None | No changes to the meaning, language, or formatting of the technical content. | | 10/25/2012 | 3.1 | None | No changes to the meaning, language, or formatting of the technical content. | | 1/31/2013 | 3.1 | None | No changes to the meaning, language, or formatting of the technical content. | | 8/8/2013 | 4.0 | Major | Updated and revised the technical content. | | 11/14/2013 | 4.1 | Minor | Clarified the meaning of the technical content. | | 2/13/2014 | 4.1 | None | No changes to the meaning, language, or formatting of the technical content. | | 5/15/2014 | 4.1 | None | No changes to the meaning, language, or formatting of the technical content. | | 6/30/2015 | 4.1 | None | No changes to the meaning, language, or formatting of the technical content. | | 10/16/2015 | 4.1 | None | No changes to the meaning, language, or formatting of the technical content. | | 7/14/2016 | 4.1 | None | No changes to the meaning, language, or formatting of the technical content. | | 6/1/2017 | 4.1 | None | No changes to the meaning, language, or formatting of the technical content. | | 9/15/2017 | 5.0 | Major | Significantly changed the technical content. | | 9/12/2018 | 6.0 | Major | Significantly changed the technical content. | | 3/15/2019 | 6.0 | None | No changes to the meaning, language, or formatting of the technical content. | | 4/7/2021 | 7.0 | Major | Significantly changed the technical content. | | 6/25/2021 | 8.0 | Major | Significantly changed the technical content. | | 4/23/2024 | 9.0 | Major | Significantly changed the technical content. | Table of Contents [1 Introduction [6](#introduction)](#introduction) [1.1 Glossary [6](#glossary)](#glossary) [1.2 References [7](#references)](#references) [1.2.1 Normative References [7](#normative-references)](#normative-references) [1.2.2 Informative References [8](#informative-references)](#informative-references) [1.3 Overview [8](#overview)](#overview) [1.3.1 Background [8](#background)](#background) [1.3.2 Properties and Property Sets [9](#properties-and-property-sets)](#properties-and-property-sets) [1.4 Relationship to Protocols and Other Structures [9](#relationship-to-protocols-and-other-structures)](#relationship-to-protocols-and-other-structures) [1.5 Applicability Statement [9](#applicability-statement)](#applicability-statement) [1.6 Versioning and Localization [9](#versioning-and-localization)](#versioning-and-localization) [1.7 Vendor-Extensible Fields [10](#vendor-extensible-fields)](#vendor-extensible-fields) [2 Structures [11](#structures)](#structures) [2.1 PropertyIdentifier [11](#propertyidentifier)](#propertyidentifier) [2.2 PropertyType [11](#propertytype)](#propertytype) [2.3 CURRENCY (Packet Version) [16](#currency-packet-version)](#currency-packet-version) [2.4 DATE (Packet Version) [16](#date-packet-version)](#date-packet-version) [2.5 CodePageString [16](#codepagestring)](#codepagestring) [2.6 DECIMAL (Packet Version) [17](#decimal-packet-version)](#decimal-packet-version) [2.7 UnicodeString [17](#unicodestring)](#unicodestring) [2.8 FILETIME (Packet Version) [17](#filetime-packet-version)](#filetime-packet-version) [2.9 BLOB [18](#blob)](#blob) [2.10 IndirectPropertyName [18](#indirectpropertyname)](#indirectpropertyname) [2.11 ClipboardData [18](#clipboarddata)](#clipboarddata) [2.12 GUID (Packet Version) [19](#guid-packet-version)](#guid-packet-version) [2.13 VersionedStream [19](#versionedstream)](#versionedstream) [2.14 Vector and Array Property Types [20](#vector-and-array-property-types)](#vector-and-array-property-types) [2.14.1 Property Types in Variable-Typed Vectors and Arrays [20](#property-types-in-variable-typed-vectors-and-arrays)](#property-types-in-variable-typed-vectors-and-arrays) [2.14.2 VectorHeader [21](#vectorheader)](#vectorheader) [2.14.3 ArrayDimension [21](#arraydimension)](#arraydimension) [2.14.4 ArrayHeader [22](#arrayheader)](#arrayheader) [2.15 TypedPropertyValue [22](#typedpropertyvalue)](#typedpropertyvalue) [2.16 DictionaryEntry [26](#dictionaryentry)](#dictionaryentry) [2.17 Dictionary [26](#dictionary)](#dictionary) [2.18 Special Properties [27](#special-properties)](#special-properties) [2.18.1 Dictionary Property [27](#dictionary-property)](#dictionary-property) [2.18.2 CodePage Property [27](#codepage-property)](#codepage-property) [2.18.3 Locale Property [28](#locale-property)](#locale-property) [2.18.4 Behavior Property [28](#behavior-property)](#behavior-property) [2.19 PropertyIdentifierAndOffset [28](#propertyidentifierandoffset)](#propertyidentifierandoffset) [2.20 PropertySet [28](#propertyset)](#propertyset) [2.21 PropertySetStream [29](#propertysetstream)](#propertysetstream) [2.22 Non-Simple Property Set Storage Format [31](#non-simple-property-set-storage-format)](#non-simple-property-set-storage-format) [2.23 Property Set Stream and Storage Names [32](#property-set-stream-and-storage-names)](#property-set-stream-and-storage-names) [2.24 Standard Bindings [33](#standard-bindings)](#standard-bindings) [2.24.1 Compound File Binding [33](#compound-file-binding)](#compound-file-binding) [2.24.2 Alternate Stream Binding [33](#alternate-stream-binding)](#alternate-stream-binding) [2.24.3 Control Stream [33](#control-stream)](#control-stream) [2.24.4 Simple Property Set Stream [34](#simple-property-set-stream)](#simple-property-set-stream) [2.24.5 Non-Simple Property Set Storage [34](#non-simple-property-set-storage)](#non-simple-property-set-storage) [2.25 Well-Known Property Set Formats [34](#well-known-property-set-formats)](#well-known-property-set-formats) [2.25.1 SummaryInformation [34](#summaryinformation)](#summaryinformation) [2.25.2 PropertyBag [36](#propertybag)](#propertybag) [3 Structure Examples [37](#structure-examples)](#structure-examples) [3.1 SummaryInformation Property Set [37](#summaryinformation-property-set)](#summaryinformation-property-set) [3.1.1 CodePage Property [39](#codepage-property-1)](#codepage-property-1) [3.1.2 PIDSI_TITLE [39](#pidsi_title)](#pidsi_title) [3.1.3 PIDSI_SUBJECT [40](#pidsi_subject)](#pidsi_subject) [3.1.4 PIDSI_AUTHOR [41](#pidsi_author)](#pidsi_author) [3.1.5 PIDSI_KEYWORDS [41](#pidsi_keywords)](#pidsi_keywords) [3.1.6 PIDSI_COMMENTS [42](#pidsi_comments)](#pidsi_comments) [3.1.7 PIDSI_TEMPLATE [42](#pidsi_template)](#pidsi_template) [3.1.8 PIDSI_LASTAUTHOR [43](#pidsi_lastauthor)](#pidsi_lastauthor) [3.1.9 PIDSI_REVNUMBER [43](#pidsi_revnumber)](#pidsi_revnumber) [3.1.10 PIDSI_APPNAME [44](#pidsi_appname)](#pidsi_appname) [3.1.11 PIDSI_EDITTIME [44](#pidsi_edittime)](#pidsi_edittime) [3.1.12 PIDSI_LASTPRINTED [45](#pidsi_lastprinted)](#pidsi_lastprinted) [3.1.13 PIDSI_CREATE_DTM [45](#pidsi_create_dtm)](#pidsi_create_dtm) [3.1.14 PIDSI_LASTSAVE_DTM [46](#pidsi_lastsave_dtm)](#pidsi_lastsave_dtm) [3.1.15 PIDSI_PAGECOUNT [46](#pidsi_pagecount)](#pidsi_pagecount) [3.1.16 PIDSI_WORDCOUNT [46](#pidsi_wordcount)](#pidsi_wordcount) [3.1.17 PIDSI_CHARCOUNT [47](#pidsi_charcount)](#pidsi_charcount) [3.1.18 PIDSI_DOC_SECURITY [47](#pidsi_doc_security)](#pidsi_doc_security) [3.2 PropertyBag Property Set [48](#propertybag-property-set)](#propertybag-property-set) [3.2.1 Control Stream ("{4c8cc155-6c1e-11d1-8e41-00c04fb9386d}") [48](#control-stream-4c8cc155-6c1e-11d1-8e41-00c04fb9386d)](#control-stream-4c8cc155-6c1e-11d1-8e41-00c04fb9386d) [3.2.2 PropertyBag Stream ("Docf\_\005Bagaaqy23kudbhchAaq5u2chNd") [48](#propertybag-stream-docf_005bagaaqy23kudbhchaaq5u2chnd)](#propertybag-stream-docf_005bagaaqy23kudbhchaaq5u2chnd) [3.2.2.1 "CONTENTS" Stream [49](#contents-stream)](#contents-stream) [3.2.2.1.1 CodePage [51](#codepage)](#codepage) [3.2.2.1.2 Locale [51](#locale)](#locale) [3.2.2.1.3 Behavior [52](#behavior)](#behavior) [3.2.2.1.4 Dictionary [52](#dictionary-1)](#dictionary-1) [3.2.2.1.4.1 Dictionary Entry 0 [53](#dictionary-entry-0)](#dictionary-entry-0) [3.2.2.1.4.2 Dictionary Entry 1 [54](#dictionary-entry-1)](#dictionary-entry-1) [3.2.2.1.4.3 Dictionary Entry 2 [54](#dictionary-entry-2)](#dictionary-entry-2) [3.2.2.1.4.4 Dictionary Entry 3 [55](#dictionary-entry-3)](#dictionary-entry-3) [3.2.2.1.4.5 Dictionary Entry 4 [55](#dictionary-entry-4)](#dictionary-entry-4) [3.2.2.1.4.6 Dictionary Entry 5 [56](#dictionary-entry-5)](#dictionary-entry-5) [3.2.2.1.5 DisplayColour [56](#displaycolour)](#displaycolour) [3.2.2.1.6 MyStream [57](#mystream)](#mystream) [3.2.2.1.7 Price(GBP) [58](#pricegbp)](#pricegbp) [3.2.2.1.8 MyStorage [58](#mystorage)](#mystorage) [3.2.2.1.9 CaseSensitive Mixed Case [59](#casesensitive-mixed-case)](#casesensitive-mixed-case) [3.2.2.1.10 CASESENSITIVE All Uppercase [60](#casesensitive-all-uppercase)](#casesensitive-all-uppercase) [3.2.2.2 "prop6" Stream [61](#prop6-stream)](#prop6-stream) [3.2.2.3 "prop12" Storage [61](#prop12-storage)](#prop12-storage) [4 Security Considerations [62](#security-considerations)](#security-considerations) [5 Appendix A: Product Behavior [63](#appendix-a-product-behavior)](#appendix-a-product-behavior) [6 Change Tracking [66](#change-tracking)](#change-tracking) [7 Index [67](#index)](#index) # Introduction This document specifies the Object Linking and Embedding (OLE) Property Set Data Structures (OLEPS), a generic persistence format for sets of [**properties**](#gt_f930baab-25f1-4142-bced-5effc9f62d45) typically used to associate simple typed metadata with a [**file**](#gt_a04c146a-de3b-4e4b-829f-a9e772f3fe25). In order for an application to make metadata discoverable to other software, it chooses a [**property set format**](#gt_662dbb07-0d00-4322-b305-fa99015511c4), either a well-known published format or an application-defined format, and writes a property set containing the properties specified for this format. In combination with technologies that support multiple virtual [**streams**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) in a single physical file, such as the Compound File Binary File Format (for details, see [\[MS-CFB\]](%5bMS-CFB%5d.pdf#Section_53989ce47b054f8d829bd08d6148375b)) or the alternate user data stream feature of certain file systems, one or more [**property sets**](#gt_dc3c2e4a-3b46-4284-973e-cc0e362a3264) can be associated with a file. This enables applications to make properties of a file discoverable to software that does not support parsing application-specific portions of the file format. Sections 1.7 and 2 of this specification are normative. All other sections and examples in this specification are informative. ## Glossary This document uses the following terms: > **alternate stream**: See named stream. > > **class identifier (CLSID)**: A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) that identifies a software component; for instance, a DCOM object class or a COM class. > > **compound file**: A file that is created as defined in [\[MS-CFB\]](%5bMS-CFB%5d.pdf#Section_53989ce47b054f8d829bd08d6148375b) and that is capable of storing data that is structured as storage and streams. > > **element**: A stream or storage that is identified by a unique name. > > **file**: An entity of data in the file system that a user can access and manage. A [**file**](#gt_a04c146a-de3b-4e4b-829f-a9e772f3fe25) must have a unique name in its directory. It consists of one or more streams of bytes that hold a set of related data, plus a set of attributes (also called properties) that describe the [**file**](#gt_a04c146a-de3b-4e4b-829f-a9e772f3fe25) or the data within the [**file**](#gt_a04c146a-de3b-4e4b-829f-a9e772f3fe25). The creation time of a [**file**](#gt_a04c146a-de3b-4e4b-829f-a9e772f3fe25) is an example of a file attribute. > > **FMTID**: A GUID value that identifies a property set format. > > **globally unique identifier (GUID)**: A term used interchangeably with universally unique identifier (UUID) in Microsoft protocol technical documents (TDs). Interchanging the usage of these terms does not imply or require a specific algorithm or mechanism to generate the value. Specifically, the use of this term does not imply or require that the algorithms described in [\[RFC4122\]](https://go.microsoft.com/fwlink/?LinkId=90460) or [\[C706\]](https://go.microsoft.com/fwlink/?LinkId=89824) must be used for generating the [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1). See also universally unique identifier (UUID). > > **GUID_NULL**: A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) that has the value "{00000000-0000-0000-0000-000000000000}". > > **little-endian**: Multiple-byte values that are byte-ordered with the least significant byte stored in the memory location with the lowest address. > > **non-simple property set**: A property set that is stored as a storage, which enables stream and storage as property types. > > **NT file system (NTFS)**: A proprietary Microsoft file system. For more information, see [\[MSFT-NTFS\]](https://go.microsoft.com/fwlink/?LinkId=90200). > > **property**: A typed value associated with a property identifier and optionally a property name. > > **property identifier**: A unique integer or a 16-bit, numeric identifier that is used to identify a specific attribute or property. > > **property name**: A string that, in combination with a [**property set**](#gt_dc3c2e4a-3b46-4284-973e-cc0e362a3264), identifies a named property. > > **property set**: A set of properties, along with an FMTID, identifying the property set format and an associated class identifier (CLSID). The CLSID is used to identify the application or component that created the property set. > > **property set format**: A specification for the properties in a property set, including the property identifier, type, semantics, and, optionally, a property name for each property. > > **simple property set**: A property set that is stored as a stream and does not enable streams and storages as property types. > > **storage**: (1) An element of a compound file that is a unit of containment for one or more storages and streams, analogous to directories in a file system, as described in \[MS-CFB\]. > > \(2\) A set of elements with an associated CLSID used to identify the application or component that created the storage. > > **storage container**: A software-provided location for a stream. > > **storage format**: A specification for encoding a particular type of data as a stream. > > **stream**: A sequence of bytes that typically encodes application data. > > **stream container**: A software-provided location for a stream. > > **stream format**: A specification for encoding a particular type of data as a stream. > > **Unicode**: A character encoding standard developed by the Unicode Consortium that represents almost all of the written languages of the world. The [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) standard [\[UNICODE5.0.0/2007\]](https://go.microsoft.com/fwlink/?LinkId=154659) provides three forms (UTF-8, UTF-16, and UTF-32) and seven schemes (UTF-8, UTF-16, UTF-16 BE, UTF-16 LE, UTF-32, UTF-32 LE, and UTF-32 BE). > > **MAY, SHOULD, MUST, SHOULD NOT, MUST NOT:** These terms (in all caps) are used as defined in [\[RFC2119\]](https://go.microsoft.com/fwlink/?LinkId=90317). All statements of optional behavior use either MAY, SHOULD, or SHOULD NOT. ## References Links to a document in the Microsoft Open Specifications library point to the correct section in the most recently published version of the referenced document. However, because individual documents in the library are not updated at the same time, the section numbers in the documents may not match. You can confirm the correct section numbering by checking the [Errata](https://go.microsoft.com/fwlink/?linkid=850906). ### Normative References We conduct frequent surveys of the normative references to assure their continued availability. If you have any issue with finding a normative reference, please contact . We will assist you in finding the relevant information. \[C706\] The Open Group, "DCE 1.1: Remote Procedure Call", C706, August 1997, [https://publications.opengroup.org/c706](https://go.microsoft.com/fwlink/?LinkId=89824) **Note** Registration is required to download the document. \[MS-CFB\] Microsoft Corporation, "[Compound File Binary File Format](%5bMS-CFB%5d.pdf#Section_53989ce47b054f8d829bd08d6148375b)". \[MS-DTYP\] Microsoft Corporation, "[Windows Data Types](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2)". \[MS-LCID\] Microsoft Corporation, "[Windows Language Code Identifier (LCID) Reference](%5bMS-LCID%5d.pdf#Section_70feba9f294e491eb6eb56532684c37f)". \[MS-OAUT\] Microsoft Corporation, "[OLE Automation Protocol](%5bMS-OAUT%5d.pdf#Section_bbb05720f72445c78d17f83c3d1a3961)". \[MS-UCODEREF\] Microsoft Corporation, "[Windows Protocols Unicode Reference](%5bMS-UCODEREF%5d.pdf#Section_4a045e08fc294f22baf416f38c2825fb)". \[RFC2119\] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997, [https://www.rfc-editor.org/info/rfc2119](https://go.microsoft.com/fwlink/?LinkId=90317) \[RFC4234\] Crocker, D., Ed., and Overell, P., "Augmented BNF for Syntax Specifications: ABNF", RFC 4234, October 2005, [https://www.rfc-editor.org/info/rfc4234](https://go.microsoft.com/fwlink/?LinkId=90462) ### Informative References \[MSDN-COM\] Microsoft Corporation, "Component Object Model", [http://msdn.microsoft.com/en-us/library/aa286559.aspx](https://go.microsoft.com/fwlink/?LinkId=89977) \[MSDN-FileStreams\] Microsoft Corporation, "File Streams", [http://msdn.microsoft.com/en-us/library/aa364404.aspx](https://go.microsoft.com/fwlink/?LinkId=90537) ## Overview The Object Linking and Embedding (OLE) Property Set Data Structures (OLEPS) enable applications to write metadata in a manner that is discoverable to other software. A [**property set**](#gt_dc3c2e4a-3b46-4284-973e-cc0e362a3264) consists of a set of [**properties**](#gt_f930baab-25f1-4142-bced-5effc9f62d45), each of which is a typed value associated with a numerical [**property identifier**](#gt_382ac1cd-8ff9-493a-bfec-d9ad08955707), and a [**globally unique identifier (GUID)**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) format identifier, or [**FMTID**](#gt_bb4ffc07-754b-4e76-81e0-06686d942c9a), which can be used to identify the semantics and expected usage of the properties. Certain FMTIDs correspond to well-known, published [**property set formats**](#gt_662dbb07-0d00-4322-b305-fa99015511c4), while other property set formats are application-defined. If an application defines its own property set format or formats, the developer of the application will typically publish (through an out-of-band mechanism) the application-defined formats and FMTIDs so that other software can recognize and use the properties in a meaningful way. In either case, the semantics and expected usage of properties in a property set are dependent on the property set format. This document does not specify the semantics of properties or assignment of property identifiers in general, nor does it specify the mechanism to be used for publishing property set formats. The OLE Property Set Data Structures Specification consists of the following: - The specification for storing a property set as a [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) or [**storage (2)**](#gt_63525252-3f66-4459-9b64-5b77f57b2f84) suitable for use with a [**file**](#gt_a04c146a-de3b-4e4b-829f-a9e772f3fe25) format or other storage (2) technology that provides containers for these abstract types. - Standard bindings for storing property set streams and storages (1) in a [**compound file**](#gt_4819d51b-789c-4d2a-ba56-88a48a87fae7) (for details see [\[MS-CFB\]](%5bMS-CFB%5d.pdf#Section_53989ce47b054f8d829bd08d6148375b)), and for storing property sets in [**alternate streams**](#gt_71cb9ca5-c721-4593-8498-c745d6a29b41) of a file, in file systems that provide such a feature. An example of a file system that provides alternate streams is [**NTFS**](#gt_86f79a17-c0be-4937-8660-0cf6ce5ddc1a) (for more information, see [\[MSDN-FileStreams\]](https://go.microsoft.com/fwlink/?LinkId=90537) ). - The specifications for the well-known property set formats, [PropertyIdentifier](#Section_f7933d282cc44b36bc238861cbcd37c4) and [PropertyBag](#Section_9353494ccc624dccbda5db10c2f25a3e). ### Background A [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) is a sequence of bytes that typically encodes application data. An example of a stream is the data contents of an ordinary [**file**](#gt_a04c146a-de3b-4e4b-829f-a9e772f3fe25). A [**stream container**](#gt_58ee6849-9bfd-4d97-aa22-4dbb6fb36e06) is a software-provided location for a stream. An example of a stream container is a file for which the provider is the file system. In order for an application to store data in a stream container, the application can either define a [**stream format**](#gt_77f4bf29-823b-4aa6-973d-559d31423b75)—a specification for encoding a particular type of data as a stream—or use an existing stream format. A [**storage (2)**](#gt_63525252-3f66-4459-9b64-5b77f57b2f84) is a collection of [**elements**](#gt_f633cdb5-cb63-4197-ad01-e7b02a745fdb) for which each element consists of either a stream or a storage (2) and a unique name that identifies the element within the storage (2). The definition of a storage (2) is recursive. For example, a storage (2) can contain another storage (2), which can in turn contain a third storage, and so on. In addition to its elements, a storage also has an associated [**class identifier (CLSID)**](#gt_e433c806-6cb6-46a2-bb95-523df8818c99), which is a [GUID](#Section_5ee5aa9d6b964e54a6bc6b1f562d616b) value typically used to identify the application or component that created the storage. For example, an application that implements a Component Object Model (COM) class (for more information, see [\[MSDN-COM\]](https://go.microsoft.com/fwlink/?LinkId=89977)) capable of parsing a storage might set the associated CLSID to the CLSID of this COM class. A [**storage container**](#gt_45e690de-dbe5-49a6-9317-ae4defe379dc) is a software-provided location for a storage. An example of a storage container is a [**compound file**](#gt_4819d51b-789c-4d2a-ba56-88a48a87fae7). In order for an application to store data in a storage container, it either defines a [**storage format**](#gt_47836016-72d2-4f37-9559-29df5393eaa6)—a specification for encoding a particular type of data as a storage—or uses an existing storage format. The specification for standard property set stream and storage names in section [2.23](#Section_e5484a833cc143a6afcf6558059fe36e) assumes that storage containers provide element-naming that is case-insensitive for at least the characters A-Z/a-z. Compound files have this property. ### Properties and Property Sets A [**property**](#gt_f930baab-25f1-4142-bced-5effc9f62d45) is a typed value associated with a numerical identifier, known as the [**property identifier**](#gt_382ac1cd-8ff9-493a-bfec-d9ad08955707). OLEPS also enables a property to be optionally associated with a string known as the [**property name**](#gt_dcd670df-c295-466f-b681-d7d91014040a). Typically, this is used to provide a human-readable description of the semantics of the property. A [**property set**](#gt_dc3c2e4a-3b46-4284-973e-cc0e362a3264) is a set of properties, along with a [**globally unique identifier (GUID)**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) format identifier, or [**FMTID**](#gt_bb4ffc07-754b-4e76-81e0-06686d942c9a). The FMTID serves to identify the [**property set format**](#gt_662dbb07-0d00-4322-b305-fa99015511c4), which is a specification for the properties in the property set, including the property identifier, type, semantics and, optionally, a property name for each property. Property identifiers and property names (if present) of the properties in a property set are distinct such that both property identifiers and property names (if present) uniquely identify properties. To accommodate specialized uses of property sets, OLEPS also enables a property set to have an associated [**class identifier (CLSID)**](#gt_e433c806-6cb6-46a2-bb95-523df8818c99), a GUID value typically used to identify the application or component that created the property set. For example, an application that persists an instance of a Component Object Model (COM) class in a property set might set the associated CLSID to the CLSID of this COM class. Two kinds of property sets are defined: [**simple property sets**](#gt_1caaa2c2-c703-4141-b99c-fe446f430f2c) and [**non-simple property sets**](#gt_5756d395-5889-485e-9611-07904421f0f3). Non-simple property sets allow a set of property types that are a superset of the types allowed by simple property sets. In particular, [**streams**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) and [**storages (1)**](#gt_63525252-3f66-4459-9b64-5b77f57b2f84) are valid types for properties in a non-simple property set, whereas these types are not valid in a simple property set. Additionally, the specification for simple property set is a [**stream format**](#gt_77f4bf29-823b-4aa6-973d-559d31423b75), whereas the specification for non-simple property sets is a [**storage format**](#gt_47836016-72d2-4f37-9559-29df5393eaa6). ## Relationship to Protocols and Other Structures The OLEPS protocol enables [**property sets**](#gt_dc3c2e4a-3b46-4284-973e-cc0e362a3264) to be stored in a [**compound file**](#gt_4819d51b-789c-4d2a-ba56-88a48a87fae7) (for details, see [\[MS-CFB\]](%5bMS-CFB%5d.pdf#Section_53989ce47b054f8d829bd08d6148375b)). ## Applicability Statement OLEPS is appropriate for writing simple metadata to a [**file**](#gt_a04c146a-de3b-4e4b-829f-a9e772f3fe25), especially when this metadata needs to be discoverable by other software. It is most appropriate when the file format itself does not provide a format-specific mechanism for writing typed [**property**](#gt_f930baab-25f1-4142-bced-5effc9f62d45). ## Versioning and Localization This document covers versioning issues in the following areas: - **Structure Versions:** The [PropertySetStream](#Section_2a4589eb9a234a8badbd3e368233c099) packet supports two versions: version 0 and version 1. Version 0 does not support some of the property types in the PropertyType enumeration and does not support the special [Behavior property](#Section_1149ab6d06bc4044940de6681c1ce4e1). These versions are defined in section [2](#Section_94f2ed968bc44c9da87b191c44f42014). - **Localization:** The encoding of strings in the [CodePageString](#Section_a4c326115b7949658f5050639c138e16) and [PropertyIdentifier](#Section_333959a3a9994eca862748a224e63e77) packets is dependent on a [**property set's**](#gt_dc3c2e4a-3b46-4284-973e-cc0e362a3264) [CodePage property](#Section_b89107367f4a469a9644aed68a71d7d1). Property sets optionally have an informational [Locale property](#Section_bb452c0779f746e0bfb7122c347cc5c8) to identify the language for strings in the property set. Localization-dependent structure content is specified in section 2. This document specifies two versions for property sets: version 0 and version 1. Version 1 supports additional [**property**](#gt_f930baab-25f1-4142-bced-5effc9f62d45) types and a special Behavior property. The granularity for versioning is the [PropertyIdentifier](#Section_6e65d6fa60444e23ae71d65d1e3b1249) packet, which usually contains a single property set. Therefore, in general, it is possible for a [**file**](#gt_a04c146a-de3b-4e4b-829f-a9e772f3fe25) to contain both version 0 and version 1 property sets. For maximum interoperability, it is recommended that implementations write property sets as version 0 unless they make use of features only supported in version 1. ## Vendor-Extensible Fields Vendors are free to define new [**property set formats**](#gt_662dbb07-0d00-4322-b305-fa99015511c4). The [**FMTIDs**](#gt_bb4ffc07-754b-4e76-81e0-06686d942c9a) of these formats are [**GUIDs**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) that are generated using the mechanism specified in [\[C706\]](https://go.microsoft.com/fwlink/?LinkId=89824) section A.2.5. # Structures Field types in packet diagrams are defined by the packet diagram and the field descriptions. All fields in packet diagrams use [**little endian**](#gt_079478cb-f4c5-4ce5-b72b-2144da5d2ce7) byte ordering unless otherwise stated. This protocol uses the following types specified in [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) and [\[MS-OAUT\]](%5bMS-OAUT%5d.pdf#Section_bbb05720f72445c78d17f83c3d1a3961). | Type | Reference | |--------------|----------------------------| | HRESULT | \[MS-DTYP\] section 2.2.18 | | FILETIME | \[MS-DTYP\] section 2.3.3 | | GUID | \[MS-DTYP\] section 2.3.4 | | LCID | \[MS-DTYP\] section 2.3.6 | | CURRENCY | \[MS-OAUT\] section 2.2.24 | | DATE | \[MS-OAUT\] section 2.2.25 | | VARIANT_BOOL | \[MS-OAUT\] section 2.2.27 | ## PropertyIdentifier The PropertyIdentifier data type represents the [**property identifier**](#gt_382ac1cd-8ff9-493a-bfec-d9ad08955707) of a [**property**](#gt_f930baab-25f1-4142-bced-5effc9f62d45) in a [**property set**](#gt_dc3c2e4a-3b46-4284-973e-cc0e362a3264). This type is declared as follows: 1. typedef unsigned int PropertyIdentifier; [TABLE] ## PropertyType The PropertyType enumeration represents the type of a [**property**](#gt_f930baab-25f1-4142-bced-5effc9f62d45) in a [**property set**](#gt_dc3c2e4a-3b46-4284-973e-cc0e362a3264). The set of types supported depends on the version of the property set, which is indicated by the **Version** field of the [PropertySetStream](#Section_6e65d6fa60444e23ae71d65d1e3b1249) packet. In addition, the property types not supported in [**simple property sets**](#gt_1caaa2c2-c703-4141-b99c-fe446f430f2c) are specified as such. PropertyType is an enumeration, which MUST be one of the following values: This type is declared as follows: 2. typedef unsigned int PropertyType; [TABLE] ## CURRENCY (Packet Version) The CURRENCY (Packet Version) packet represents a CURRENCY as specified in [\[MS-OAUT\]](%5bMS-OAUT%5d.pdf#Section_bbb05720f72445c78d17f83c3d1a3961) section 2.2.24. [TABLE] **int64 (8 bytes):** The value of the **int64** field specified in \[MS-OAUT\] section 2.2.24. ## DATE (Packet Version) The DATE (Packet Version) packet represents a DATE as specified in[\[MS-OAUT\]](%5bMS-OAUT%5d.pdf#Section_bbb05720f72445c78d17f83c3d1a3961) section 2.2.25. [TABLE] **Value (8 bytes):** The value of the **DATE** is an 8-byte IEEE floating-point number, as specified in \[MS-OAUT\] section 2.2.25. ## CodePageString The CodePageString packet represents a string whose encoding depends on the value of the [**property set's**](#gt_dc3c2e4a-3b46-4284-973e-cc0e362a3264) [CodePage property](#Section_b89107367f4a469a9644aed68a71d7d1). [TABLE] **Size (4 bytes):** The size in bytes of the **Characters** field, including the null terminator, but not including padding (if any). If the property set's CodePage property has the value CP_WINUNICODE (0x04B0), then the value MUST be a multiple of 2. **Characters (variable):** If **Size** is zero, this field MUST be zero bytes in length. If **Size** is nonzero and the CodePage property set's CodePage property has the value CP_WINUNICODE (0x04B0), then the value MUST be a null-terminated array of 16-bit [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters, followed by zero padding to a multiple of 4 bytes. If **Size** is nonzero and the property set's CodePage property has any other value, it MUST be a null-terminated array of 8-bit characters from the code page identified by the CodePage property, followed by zero padding to a multiple of 4 bytes. The string represented by this field MAY contain embedded or additional trailing null characters and an OLEPS implementation MUST be able to handle such strings. However, the manner in which strings with embedded or additional trailing null characters are presented by the implementation to an application is implementation-specific.[\<1\>](#Appendix_A_1) For maximum interoperability, an OLEPS implementation SHOULD NOT write strings with embedded or trailing null characters unless specifically requested to do so by an application. ## DECIMAL (Packet Version) The DECIMAL (Packet Version) packet represents a DECIMAL as specified in [\[MS-OAUT\]](%5bMS-OAUT%5d.pdf#Section_bbb05720f72445c78d17f83c3d1a3961) section 2.2.26. [TABLE] **wReserved (2 bytes):** MUST be set to zero and MUST be ignored. **scale (1 byte):** The value of the **scale** field specified in \[MS-OAUT\] section 2.2.26. **sign (1 byte):** The value of the **sign** field specified in \[MS-OAUT\] section 2.2.26. **Hi32 (4 bytes):** The value of the **Hi32** field specified in \[MS-OAUT\] section 2.2.26. **Lo64 (8 bytes):** The value of the **Lo64** field specified in \[MS-OAUT\] section 2.2.26. ## UnicodeString The UnicodeString packet represents a [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string. [TABLE] **Length (4 bytes):** The length in 16-bit Unicode characters of the **Characters** field, including the null terminator, but not including padding (if any). **Characters (variable):** If **Length** is zero, this field MUST be zero bytes in length. If **Length** is nonzero, this field MUST be a null-terminated array of 16-bit Unicode characters, followed by zero padding to a multiple of 4 bytes. The string represented by this field SHOULD NOT contain embedded or additional trailing null characters. ## FILETIME (Packet Version) The FILETIME (Packet Version) packet represents a FILETIME structure ([\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) section 2.3.3). [TABLE] **dwLowDateTime (4 bytes):** The value of the **dwLowDateTime** field specified in \[MS-DTYP\] section 2.3.3. **dwHighDateTime (4 bytes):** The value of the **dwHighDateTime** field specified in \[MS-DTYP\] section 2.3.3. ## BLOB The BLOB packet represents binary data. [TABLE] **Size (4 bytes):** The size in bytes of the **Bytes** field, not including padding (if any). **Bytes (variable):** MUST be an array of bytes, followed by zero padding to a multiple of 4 bytes. ## IndirectPropertyName The IndirectPropertyName packet represents the name of a [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) or storage as used in the representation of the following property types in a [**non-simple property set**](#gt_5756d395-5889-485e-9611-07904421f0f3): VT_STREAM (0x0042), VT_STORAGE (0x0043), VT_STREAMED_OBJECT (0x0044), VT_STORED_OBJECT (0x0044), and VT_VERSIONED_STREAM (0x0049). It MUST be represented as a [CodePageString](#Section_a4c326115b7949658f5050639c138e16), and its value MUST be derived from the [**property identifier**](#gt_382ac1cd-8ff9-493a-bfec-d9ad08955707) of the [**property**](#gt_f930baab-25f1-4142-bced-5effc9f62d45) represented according to the following Augmented Backus–Naur Form (ABNF) [\[RFC4234\]](https://go.microsoft.com/fwlink/?LinkId=90462) syntax. 3. Indirectproperty = "prop" propertyIdentifier Where [PropertyIdentifier](#Section_04727953c1744d0180aeb38b15d7068a) is the decimal string representation of the property identifier. This property identifier MUST be a valid PropertyIdentifier value and MUST NOT be the property identifier for any of the special properties specified in section [2.18](#Section_9389a815d71c4dd2b2722b3a8177f004). ## ClipboardData The ClipboardData packet represents clipboard data. [TABLE] **Size (4 bytes):** The total size in bytes of the **Format** and **Data** fields, not including padding (if any). **Format (4 bytes):** An application-specific identifier for the format of the data in the **Data** field. **Data (variable):** MUST be an array of bytes, followed by zero padding to a multiple of 4 bytes. ## GUID (Packet Version) The GUID (Packet Version) packet represents a [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1). [TABLE] **Data1 (4 bytes):** The value of the **Data1** field specified in [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) section 2.3.4. **Data2 (2 bytes):** The value of the **Data2** field specified in \[MS-DTYP\] section 2.3.4. **Data3 (2 bytes):** The value of the **Data3** field specified in \[MS-DTYP\] section 2.3.4. **Data4 (8 bytes):** The value of the **Data4** field specified in \[MS-DTYP\] section 2.3.4. ## VersionedStream The VersionedStream packet represents a [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) with an application-specific version [GUID](#Section_5ee5aa9d6b964e54a6bc6b1f562d616b). [TABLE] **VersionGuid (16 bytes):** MUST be a GUID (Packet Version). **StreamName (variable):** MUST be an [IndirectPropertyName](#Section_e3bdb60847564a0cb2fd15b7eee52905). ## Vector and Array Property Types Several property types are defined to be a vector or an array of another property type, known as the property's scalar type. **Vector** types, indicated by a [PropertyType](#Section_2a4589eb9a234a8badbd3e368233c099) value with the VT_VECTOR (0x1000) bit set, are simple, one-dimensional arrays of the scalar type. **Array** types, indicated by a PropertyType value with the VT_ARRAY (0x2000) bit set, are multi-dimensional arrays of the scalar type, with [**elements**](#gt_f633cdb5-cb63-4197-ad01-e7b02a745fdb) in row-major order (that is, elements with indices differing only in that the highest-numbered dimensions are consecutive). All such types are represented by a header, which provides information on the size and dimensions of the vector or array, followed by a sequence of scalar values. The following sections provide details on the representation of vector and array property types. ### Property Types in Variable-Typed Vectors and Arrays The property types **VT_VECTOR \| VT_VARIANT** (0x100C) and **VT_ARRAY \| VT_VARIANT** (0x200C) are variable-typed sequences in which each scalar value has its own type. The types of the individual scalar values in such a [**property**](#gt_f930baab-25f1-4142-bced-5effc9f62d45) MUST be taken from the following subset of the [PropertyType](#Section_2a4589eb9a234a8badbd3e368233c099) enumeration values. | Value | Allowed in VT_VECTOR \| VT_VARIANT property? | Allowed in VT_ARRAY \| VT_VARIANT property? | |----|----|----| | VT_I2 (0x0002) | Yes | Yes | | VT_I4 (0x0003) | Yes | Yes | | VT_R4 (0x0004) | Yes | Yes | | VT_R8 (0x0005) | Yes | Yes | | VT_CY (0x0006) | Yes | Yes | | VT_DATE (0x0007) | Yes | Yes | | VT_BSTR (0x0008) | Yes | Yes | | VT_ERROR (0x000A) | Yes | Yes | | VT_BOOL (0x000B) | Yes | Yes | | VT_DECIMAL (0x000E) | No | Yes | | VT_I1 (0x0010) | Yes | Yes | | VT_UI1 (0x0011) | Yes | Yes | | VT_UI2 (0x0012) | Yes | Yes | | VT_UI4 (0x0013) | Yes | Yes | | VT_I8 (0x0014) | Yes | No | | VT_UI8 (0x0015) | Yes | No | | VT_INT (0x0016) | No | Yes | | VT_UINT (0x0017) | No | Yes | | VT_LPSTR (0x001E) | Yes | No | | VT_LPWSTR (0x001F) | Yes | No | | VT_FILETIME (0x0040) | Yes | No | | VT_CF (0x0047) | Yes | No | | VT_CLSID (0x0048) | Yes | No | ### VectorHeader The VectorHeader packet represents the number of scalar values in a vector property type. [TABLE] **Length (4 bytes):** An unsigned integer indicating the number of scalar values following the header. ### ArrayDimension The ArrayDimension packet represents the size and index offset of a dimension of an array property type. [TABLE] **Size (4 bytes):** An unsigned integer representing the size of the dimension. **IndexOffset (4 bytes):** A signed integer representing the index offset of the dimension. For example, an array dimension that is to be accessed with a 0-based index would have the value zero, whereas an array dimension that is to be accessed with a 1-based index would have the value 0x00000001. | Value | Meaning | |----|----| | 0 | An array dimension that is to be accessed with a 0-based index would have the value zero. | | 0x00000001 | An array dimension that is to be accessed with a 1-based index would have the value 0x00000001. | ### ArrayHeader The ArrayHeader packet represents the type and dimensions of an array property type. [TABLE] **Type (4 bytes):** MUST be set to the value obtained by clearing the VT_ARRAY (0x2000) bit of this array property's [PropertyType](#Section_2a4589eb9a234a8badbd3e368233c099) value. **NumDimensions (4 bytes):** An unsigned integer representing the number of dimensions in the array property. MUST be at least 1 and at most 31. | Value | Meaning | |----|----| | 1 — 31 | An unsigned integer representing the number of dimensions in the array property. | **Dimension 0 (variable):** MUST be a sequence of [ArrayDimension](#Section_7db5c301aacb4f45b95646ee7010bf90) packets. The number of scalar values in an array property can be calculated from the ArrayHeader packet as the product of the **Size** fields of each of the ArrayDimension packets. ## TypedPropertyValue The TypedPropertyValue structure represents the typed value of a [**property**](#gt_f930baab-25f1-4142-bced-5effc9f62d45) in a property set. [TABLE] **Type (2 bytes):** MUST be a value from the [PropertyType](#Section_2a4589eb9a234a8badbd3e368233c099) enumeration, indicating the type of property represented. **Padding (2 bytes):** MUST be set to zero, and any nonzero value SHOULD be rejected. | Value | Meaning | |-------|--------------| | 0 | As required. | **Value (variable):** MUST be the value of the property represented and serialized according to the value of **Type** as follows. | Type | Format | |----|----| | VT_EMPTY (0x0000) | MUST be zero bytes in length. | | VT_NULL (0x0001) | MUST be zero bytes in length. | | VT_I2 (0x0002) | MUST be a **16-bit signed integer**, followed by zero padding to 4 bytes. | | VT_I4 (0x0003) | MUST be a **32-bit signed integer**. | | VT_R4 (0x0004) | MUST be a **4-byte (single-precision) IEEE floating-point number**. | | VT_R8 (0x0005) | MUST be an **8-byte (double-precision) IEEE floating-point number**. | | VT_CY (0x0006) | MUST be a [CURRENCY](#Section_fb1fc39313a945399bbb9c696434c6e0) (Packet Version). | | VT_DATE (0x0007) | MUST be a DATE (Packet Version). | | VT_BSTR (0x0008) | MUST be a [CodePageString](#Section_a4c326115b7949658f5050639c138e16). | | VT_ERROR (0x000A) | MUST be a **32-bit unsigned integer** representing an HRESULT, as specified in [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) section 2.2.18. | | VT_BOOL (0x000B) | MUST be a **VARIANT_BOOL** as specified in [\[MS-OAUT\]](%5bMS-OAUT%5d.pdf#Section_bbb05720f72445c78d17f83c3d1a3961) section 2.2.27, followed by zero padding to 4 bytes. | | VT_DECIMAL (0x000E) | MUST be a [DECIMAL](#Section_8c12ac7edc0b42819753b58b58dcd2b3) (Packet Version). | | VT_I1 (0x0010) | MUST be a **1-byte signed integer**, followed by zero padding to 4 bytes. | | VT_UI1 (0x0011) | MUST be a **1-byte unsigned integer**, followed by zero padding to 4 bytes. | | VT_UI2 (0x0012) | MUST be a **2-byte unsigned integer**, followed by zero padding to 4 bytes. | | VT_UI4 (0x0013) | MUST be a **4-byte unsigned integer**. | | VT_I8 (0x0014) | MUST be an **8-byte signed integer**. | | VT_UI8 (0x0015) | MUST be an **8-byte unsigned integer**. | | VT_INT (0x0016) | MUST be a **4-byte signed integer**. | | VT_UINT (0x0017) | MUST be a **4-byte unsigned integer**. | | VT_LPSTR (0x001E) | MUST be a CodePageString. | | VT_LPWSTR (0x001F) | MUST be a [UnicodeString](#Section_9660cb24953a4e60adf237cc0e779d19). | | VT_FILETIME (0x0040) | MUST be a [FILETIME (Packet Version)](#Section_d8070a967f0c4235b4a1112876f2a419). | | VT_BLOB (0x0041) | MUST be a [BLOB](#Section_8d5b277838214e2db1fcf52d6ad1e446). | | VT_STREAM (0x0042) | MUST be an [IndirectPropertyName](#Section_e3bdb60847564a0cb2fd15b7eee52905). The storage representing the (non-simple) property set MUST have a stream element with this name. | | VT_STORAGE (0x0043) | MUST be an IndirectPropertyName. The storage representing the (non-simple) property set MUST have a storage element with this name. | | VT_STREAMED_OBJECT (0x0044) | MUST be an IndirectPropertyName. The storage representing the (non-simple) property set MUST have a stream element with this name. | | VT_STORED_OBJECT (0x0045) | MUST be an IndirectPropertyName. The storage representing the (non-simple) property set MUST have a storage element with this name. | | VT_BLOB_OBJECT (0x0046) | MUST be a BLOB. | | VT_CF (0x0047) | MUST be a [ClipboardData](#Section_e51754139dad4a8dbd1f058eb301fdc9). | | VT_CLSID (0x0048) | MUST be a [GUID](#Section_5ee5aa9d6b964e54a6bc6b1f562d616b) (Packet Version). | | VT_VERSIONED_STREAM (0x0049) | MUST be a [VersionedStream](#Section_7c6776d18f2c4693aa7e281bcbc61a1f). The storage representing the (non-simple) property set MUST have a stream element with the name in the **StreamName** field. | | VT_VECTOR \| VT_I2 (0x1002) | MUST be a [VectorHeader](#Section_f288f09af6a0493290920a80f86febf6) followed by a sequence of **16-bit signed integers**, followed by zero padding to a total length that is a multiple of 4 bytes. | | VT_VECTOR \| VT_I4 (0x1003) | MUST be a VectorHeader followed by a sequence of **32-bit signed integers**. | | VT_VECTOR \| VT_R4 (0x1004) | MUST be a VectorHeader followed by a sequence of **4-byte (single-precision) IEEE floating-point numbers**. | | VT_VECTOR \| VT_R8 (0x1005) | MUST be a VectorHeader followed by a sequence of **8-byte (double-precision) IEEE floating-point numbers**. | | VT_VECTOR \| VT_CY (0x1006) | MUST be a VectorHeader followed by a sequence of CURRENCY (Packet Version) packets. | | VT_VECTOR \| VT_DATE (0x1007) | MUST be a VectorHeader followed by a sequence of DATE (Packet Version) packets. | | VT_VECTOR \| VT_BSTR (0x1008) | MUST be a VectorHeader followed by a sequence of CodePageString packets. | | VT_VECTOR \| VT_ERROR (0x100A) | MUST be a VectorHeader followed by a sequence of **32-bit unsigned integers** representing HRESULTs, as specified in \[MS-DTYP\] section 2.2.18. | | VT_VECTOR \| VT_BOOL (0x100B) | MUST be a VectorHeader followed by a sequence of **VARIANT_BOOL** as specified in \[MS-OAUT\] section 2.2.27, followed by zero padding to a total length that is a multiple of 4 bytes. | | VT_VECTOR \| VT_VARIANT (0x100C) | MUST be a VectorHeader followed by a sequence of TypedPropertyValue packets. | | VT_VECTOR \| VT_I1 (0x1010) | MUST be a VectorHeader followed by a sequence of **1-byte signed integers**, followed by zero padding to a total length that is a multiple of 4 bytes. | | VT_VECTOR \| VT_UI1 (0x1011) | MUST be a VectorHeader followed by a sequence of **1-byte unsigned integers**, followed by zero padding to a total length that is a multiple of 4 bytes. | | VT_VECTOR \| VT_UI2 (0x1012) | MUST be a VectorHeader followed by a sequence of **2-byte unsigned integers**, followed by zero padding to a total length that is a multiple of 4 bytes. | | VT_VECTOR \| VT_UI4 (0x1013) | MUST be a VectorHeader followed by a sequence of **4-byte unsigned integers**. | | VT_VECTOR \| VT_I8 (0x1014) | MUST be a VectorHeader followed by a sequence of **8-byte signed integers**. | | VT_VECTOR \| VT_UI8 (0x1015) | MUST be a VectorHeader followed by a sequence of **8-byte unsigned integers**. | | VT_VECTOR \| VT_LPSTR (0x101E) | MUST be a VectorHeader followed by a sequence of CodePageString packets. | | VT_VECTOR \| VT_LPWSTR (0x101F) | MUST be a VectorHeader followed by a sequence of UnicodeString packets. | | VT_VECTOR \| VT_FILETIME (0x1040) | MUST be a VectorHeader followed by a sequence of FILETIME (Packet Version) packets. | | VT_VECTOR \| VT_CF (0x1047) | MUST be a VectorHeader followed by a sequence of ClipboardData packets. | | VT_VECTOR \| VT_CLSID (0x1048) | MUST be a VectorHeader followed by a sequence of GUID (Packet Version) packets. | | VT_ARRAY \| VT_I2 (0x2002) | MUST be an [ArrayHeader](#Section_e74a8869440b43a4985c70b850b8aeed) followed by a sequence of **16-bit signed integers**, followed by zero padding to a total length that is a multiple of 4 bytes. | | VT_ARRAY \| VT_I4 (0x2003) | MUST be an ArrayHeader followed by a sequence of **32-bit signed integers**. | | VT_ARRAY \| VT_R4 (0x2004) | MUST be an ArrayHeader followed by a sequence of **4-byte (single-precision) IEEE floating-point numbers**. | | VT_ARRAY \| VT_R8 (0x2005) | MUST be an ArrayHeader followed by a sequence of **8-byte (double-precision) IEEE floating-point numbers**. | | VT_ARRAY \| VT_CY (0x2006) | MUST be an ArrayHeader followed by a sequence of CURRENCY (Packet Version) packets. | | VT_ARRAY \| VT_DATE (0x2007) | MUST be an ArrayHeader followed by a sequence of DATE (Packet Version) packets. | | VT_ARRAY \| VT_BSTR (0x2008) | MUST be an ArrayHeader followed by a sequence of CodePageString packets. | | VT_ARRAY \| VT_ERROR (0x200A) | MUST be an ArrayHeader followed by a sequence of **32-bit unsigned integers** representing HRESULTs, as specified in \[MS-DTYP\] section 2.2.18. | | VT_ARRAY \| VT_BOOL (0x200B) | MUST be an ArrayHeader followed by a sequence of VARIANT_BOOL as specified in \[MS-OAUT\] section 2.2.27, followed by zero padding to a total length that is a multiple of 4 bytes. | | VT_ARRAY \| VT_VARIANT (0x200C) | MUST be an ArrayHeader followed by a sequence of TypedPropertyValue packets. | | VT_ARRAY \| VT_DECIMAL (0x200E) | MUST be an ArrayHeader followed by a sequence of DECIMAL (Packet Version) packets. | | VT_ARRAY \| VT_I1 (0x2010) | MUST be an ArrayHeader followed by a sequence of **1-byte signed integers**, followed by zero padding to a total length that is a multiple of 4 bytes. | | VT_ARRAY \| VT_UI1 (0x2011) | MUST be an ArrayHeader followed by a sequence of **1-byte unsigned integers**, followed by zero padding to a total length that is a multiple of 4 bytes. | | VT_ARRAY \| VT_UI2 (0x2012) | MUST be an ArrayHeader followed by a sequence of **2-byte unsigned integers**, followed by zero padding to a total length that is a multiple of 4 bytes. | | VT_ARRAY \| VT_UI4 (0x2013) | MUST be an ArrayHeader followed by a sequence of **4-byte unsigned integers**. | | VT_ARRAY \| VT_INT (0x2016) | MUST be an ArrayHeader followed by a sequence of **4-byte signed integers**. | | VT_ARRAY \| VT_UINT (0x2017) | MUST be an ArrayHeader followed by a sequence of **4-byte unsigned integers**. | ## DictionaryEntry The DictionaryEntry packet represents a mapping between a property identifier and a [**property name**](#gt_dcd670df-c295-466f-b681-d7d91014040a). [TABLE] **PropertyIdentifier (4 bytes):** An unsigned integer representing a property identifier. MUST be a valid [PropertyIdentifier](#Section_04727953c1744d0180aeb38b15d7068a) value in the range 0x00000002 to 0x7FFFFFFF, inclusive (this specifically excludes the [**property identifiers**](#gt_382ac1cd-8ff9-493a-bfec-d9ad08955707) for any of the special properties specified in section [2.18](#Section_9389a815d71c4dd2b2722b3a8177f004)). **Length (4 bytes):** If the property set's [CodePage property](#Section_b89107367f4a469a9644aed68a71d7d1) has the value CP_WINUNICODE (0x04B0), MUST be the length of the **Name** field in 16-bit [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters, including the null terminator but not including padding (if any). Otherwise, MUST be the length of the **Name** field in 8-bit characters, including the null terminator. **Name (variable):** If the property set's CodePage property has the value CP_WINUNICODE (0x04B0), MUST be a null-terminated array of 16-bit Unicode characters, followed by zero padding to a multiple of 4 bytes. Otherwise, MUST be a null-terminated array of 8-bit characters from the code page identified by the CodePage property and MUST NOT be padded. ## Dictionary The Dictionary packet represents all mappings between [**property identifiers**](#gt_382ac1cd-8ff9-493a-bfec-d9ad08955707) and [**property names**](#gt_dcd670df-c295-466f-b681-d7d91014040a) in a property set. [TABLE] **NumEntries (4 bytes):** (4 bytes) An unsigned integer representing the number of entries in the Dictionary. **Entry 1 (variable):** All Entry fields MUST be a sequence of [DictionaryEntry](#Section_333959a3a9994eca862748a224e63e77) packets. Entries are not required to appear in any particular order. **Padding (variable):** Padding, if necessary, to a total length that is a multiple of 4 bytes. ## Special Properties The following sections provide additional information on [**properties**](#gt_f930baab-25f1-4142-bced-5effc9f62d45) that have special representation, usage, or restrictions. ### Dictionary Property The Dictionary property, if present, MUST have a property identifier of 0x00000000 and MUST NOT have a [**property name**](#gt_dcd670df-c295-466f-b681-d7d91014040a). Unlike other properties, which are represented as [TypedPropertyValue](#Section_f122b9d7e5cf4484846683f6fd94b3cc) packets, the Dictionary property MUST be represented as a [Dictionary](#Section_99127b7fc440469791a4c853086d6b33) packet. A property set in which any [**properties**](#gt_f930baab-25f1-4142-bced-5effc9f62d45) have property names MUST have a Dictionary property. The Dictionary property MUST NOT have multiple entries with the same property identifier or multiple entries with the same property name. Property names MUST be compared in a case-insensitive manner unless the property set has a [Behavior property](#Section_1149ab6d06bc4044940de6681c1ce4e1) with the value 0x00000001, in which case property names MUST be compared in a case-sensitive manner. ### CodePage Property The CodePage property MUST have the property identifier 0x00000001, MUST NOT have a [**property name**](#gt_dcd670df-c295-466f-b681-d7d91014040a), and MUST have type VT_I2 (0x0002). Every property set MUST have a CodePage property and its value MUST be a valid code page identifier as specified in [\[MS-UCODEREF\]](%5bMS-UCODEREF%5d.pdf#Section_4a045e08fc294f22baf416f38c2825fb) section 2.2.1. Its value is selected in an implementation-specific manner.[\<2\>](#Appendix_A_2) The CodePage property of a property set affects the representation of the [CodePageString](#Section_a4c326115b7949658f5050639c138e16) and [DictionaryEntry](#Section_333959a3a9994eca862748a224e63e77) packets. The value CP_WINUNICODE (0x04B0) indicates that the strings in these packets are encoded as arrays of 16-bit [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters. Any other value indicates that the strings in these packets are encoded as arrays of 8-bit characters from the code page identified. ### Locale Property The Locale property, if present, MUST have the property identifier 0x80000000, MUST NOT have a [**property name**](#gt_dcd670df-c295-466f-b681-d7d91014040a), and MUST have type VT_UI4 (0x0013). If present, its value MUST be a valid language code identifier as specified in [\[MS-LCID\]](%5bMS-LCID%5d.pdf#Section_70feba9f294e491eb6eb56532684c37f). Its value is selected in an implementation-specific manner.[\<3\>](#Appendix_A_3) ### Behavior Property The Behavior property, if present, MUST have the property identifier 0x80000003, MUST NOT have a [**property name**](#gt_dcd670df-c295-466f-b681-d7d91014040a), and MUST have type VT_UI4 (0x0013). A version 0 property set, indicated by the value 0x0000 for the **Version** field of the [PropertySetStream](#Section_6e65d6fa60444e23ae71d65d1e3b1249) packet, MUST NOT have a Behavior property. If the Behavior property is present, it MUST have one of the following values. | Value | Meaning | |------------|------------------------------------------------| | 0x00000000 | Property names are case-insensitive (default). | | 0x00000001 | Property names are case-sensitive. | ## PropertyIdentifierAndOffset The PropertyIdentifierAndOffset packet is used in the [PropertySet](#Section_aefcbddff2994f5ea9da65ce4ca55075) packet to represent a property identifier and the byte offset of the property in the PropertySet packet. [TABLE] **PropertyIdentifier (4 bytes):** An unsigned integer representing the property identifier of a property in the property set. MUST be a valid [PropertyIdentifier](#Section_04727953c1744d0180aeb38b15d7068a) value. **Offset (4 bytes):** An unsigned integer representing the offset in bytes from the beginning of the PropertySet packet to the beginning of the **Property** field for the property represented. MUST be a multiple of 4 bytes. ## PropertySet The PropertySet packet represents a property set. [TABLE] **Size (4 bytes):** MUST be the total size in bytes of the PropertySet packet. **NumProperties (4 bytes):** An unsigned integer representing the number of [**properties**](#gt_f930baab-25f1-4142-bced-5effc9f62d45) in the property set. **PropertyIdentifierAndOffset 0 (variable):** All PropertyIdentifierAndOffset fields MUST be a sequence of [PropertyIdentifierAndOffset](#Section_f59e6c94a0ae4d1b85d3f01c35779a22) packets. The sequence MUST be in order of increasing value of the **Offset** field. Packets are not required to be in any particular order with regard to the value of the **PropertyIdentifier** field. **Property 0 (variable):** Each Property field is a sequence of property values, each of which MUST be represented by a [TypedPropertyValue](#Section_f122b9d7e5cf4484846683f6fd94b3cc) packet or a [Dictionary](#Section_99127b7fc440469791a4c853086d6b33) packet in the special case of the [Dictionary property](#Section_4177a4bc554749fea4d94767350fd9cf). ## PropertySetStream The PropertySetStream packet specifies the [**stream format**](#gt_77f4bf29-823b-4aa6-973d-559d31423b75) for [**simple property sets**](#gt_1caaa2c2-c703-4141-b99c-fe446f430f2c) and the stream format for the CONTENTS stream in the [Non-Simple Property Set Storage Format](#Section_83b0f8316adf48c58befb62e7ac1cc1e). A simple property set MUST be represented by a [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) containing a PropertySetStream packet. The PropertySetStream packet usually represents exactly one property set, but for historical reasons, the DocumentSummaryInfo and UserDefinedProperties [**property sets**](#gt_dc3c2e4a-3b46-4284-973e-cc0e362a3264) are represented in the same stream. In this special case, a PropertySetStream might represent two property sets. An implementation SHOULD enforce a limit on the total size of a PropertySetStream packet. This limit MUST be at least 262,144 bytes, and for maximum interoperability SHOULD[\<4\>](#Appendix_A_4) be 2,097,152 bytes. [TABLE] **ByteOrder (2 bytes):** MUST be set to 0xFFFE. **Version (2 bytes):** An unsigned integer indicating the version number of the property set (or property sets). MUST be 0x0000 or 0x0001. An OLEPS implementation MUST accept version 0 property sets and SHOULD[\<5\>](#Appendix_A_5) also accept version 1 property sets. This field MUST be set to 0x0001 if the property set or property sets use any of the following features not supported by version 0 property sets: - Property types not supported for version 0 property sets, as specified in the [PropertyType](#Section_2a4589eb9a234a8badbd3e368233c099) enumeration. - The [Behavior property](#Section_1149ab6d06bc4044940de6681c1ce4e1). > If the property set does not use any of these features, this field SHOULD be set to 0x0000 for maximum interoperability. | Value | Meaning | |--------|---------------------------------------| | 0x0000 | Version 0 property sets will be used. | | 0x0001 | Version 1 property sets will be used. | **SystemIdentifier (4 bytes):** An implementation-specific[\<6\>](#Appendix_A_6) value that SHOULD be ignored, except possibly to report this value to applications. It SHOULD NOT be interpreted by the OLEPS implementation. **CLSID (16 bytes):** MUST be a [GUID](#Section_5ee5aa9d6b964e54a6bc6b1f562d616b) (Packet Version) packet representing the associated [**CLSID**](#gt_e433c806-6cb6-46a2-bb95-523df8818c99) of the property set (or property sets). If no CLSID is provided by the application, it SHOULD be set to [**GUID_NULL**](#gt_b9d97d88-9398-4450-9e92-247073ce0362) by default. **NumPropertySets (4 bytes):** An unsigned integer indicating the number of property sets represented by this PropertySetStream structure. MUST be either 0x00000001 or 0x00000002. | Value | Meaning | |----|----| | 0x00000001 | This structure contains one property set. | | 0x00000002 | This structure contains two property sets. The optional fields for **PropertySet 1** are present. | **FMTID0 (16 bytes):** A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) that MUST be set to the [**FMTID**](#gt_bb4ffc07-754b-4e76-81e0-06686d942c9a) of the property set represented by the field **PropertySet 0**. If **NumPropertySets** has the value 0x00000002, then this GUID MUST be set to FMTID_DocSummaryInformation ({D5CDD502-2E9C-101B-9397-08002B2CF9AE}). **Offset0 (4 bytes):** An unsigned integer that MUST be set to the offset in bytes from the beginning of this PropertySetStream structure to the beginning of the field **PropertySet 0**. **FMTID1 (16 bytes):** If **NumPropertySets** has the value 0x00000002, it MUST be set to FMTID_UserDefinedProperties ({D5CDD505-2E9C-101B-9397-08002B2CF9AE}). Otherwise, it MUST be absent. **Offset1 (4 bytes):** If **NumPropertySets** has the value 0x00000002, it MUST be set to the offset in bytes from the beginning of this PropertySetStream structure to the beginning of the field **PropertySet 1**. Otherwise, it MUST be absent. **PropertySet0 (variable):** MUST be a [PropertySet](#Section_aefcbddff2994f5ea9da65ce4ca55075) packet. **PropertySet1 (variable):** If **NumPropertySets** has the value 0x00000002, it MUST be a PropertySet packet. Otherwise, it MUST be absent. **Padding (variable):** Contains additional padding added by the implementation. If present, padding MUST be zeroes and MUST be ignored. ## Non-Simple Property Set Storage Format A [**non-simple property set**](#gt_5756d395-5889-485e-9611-07904421f0f3) MUST be represented by a storage. This storage MUST have a stream element with the name "CONTENTS", which MUST contain a [PropertySetStream](#Section_6e65d6fa60444e23ae71d65d1e3b1249) packet. The [**CLSID**](#gt_e433c806-6cb6-46a2-bb95-523df8818c99) of the storage MUST be set to the associated CLSID of the property set from the **CLSID** field of the PropertySetStream packet. In addition, the property set MUST have an [**element**](#gt_f633cdb5-cb63-4197-ad01-e7b02a745fdb) for each property of the following types: | Property Type | Element Type | |----|----| | VT_STREAM (0x0042) | [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) | | VT_STORAGE(0x0043) | [**storage (2)**](#gt_63525252-3f66-4459-9b64-5b77f57b2f84) | | VT_STREAMED_OBJECT (0x0044) | stream | | VT_STORED_OBJECT (0x0044) | storage (2) | | VT_VERSIONED_STREAM (0x0049) | stream | Each of these elements MUST have the name specified in the property's [IndirectPropertyName](#Section_e3bdb60847564a0cb2fd15b7eee52905) packet. ## Property Set Stream and Storage Names A [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) or storage representing a property set might be an [**element**](#gt_f633cdb5-cb63-4197-ad01-e7b02a745fdb) of a storage. For example, the standard binding for property set streams or storages in a [**compound file**](#gt_4819d51b-789c-4d2a-ba56-88a48a87fae7) requires each to be an element of the root storage of the [**file**](#gt_a04c146a-de3b-4e4b-829f-a9e772f3fe25). This section specifies a standard mapping between a property set's [**FMTID**](#gt_bb4ffc07-754b-4e76-81e0-06686d942c9a) and the name for the stream or storage element representing the property set, so that property sets stored in this way are discoverable. An OLEPS implementation SHOULD provide a mechanism by which elements with names derived according to this standard mapping are used for property sets, although the implementation MAY[\<7\>](#Appendix_A_7) additionally provide one or more other mechanisms that do not follow this convention. For example, the implementation might provide a mechanism by which a property set can be stored in an arbitrary application-provided [**stream container**](#gt_58ee6849-9bfd-4d97-aa22-4dbb6fb36e06) or [**storage container**](#gt_45e690de-dbe5-49a6-9317-ae4defe379dc). The following ABNF [\[RFC4234\]](https://go.microsoft.com/fwlink/?LinkId=90462) syntax specifies the standard names for property set streams and storages. 4. PropertySetStreamOrStorageName = %x05 ("SummaryInformation" / "DocumentSummaryInformation" / "GlobalInfo" / "ImageContents" / "ImageInfo" / 26(ALPHA / "0" / "1" / "2" / "3" / "4" / "5") ) The special-case FMTID values listed in the following table MUST be mapped to the names as specified in the table. | FMTID | Stream or storage name | |----|----| | FMTID_SummaryInformation {F29F85E0-4FF9-1068-AB91-08002B27B3D9} | "\005SummaryInformation" | | FMTID_DocSummaryInformation {D5CDD502-2E9C-101B-9397-08002B2CF9AE} | "\005DocumentSummaryInformation" | | FMTID_UserDefinedProperties {D5CDD505-2E9C-101B-9397-08002B2CF9AE} | "\005DocumentSummaryInformation" | | FMTID_GlobalInfo {56616F00-C154-11CE-8553-00AA00A1F95B} | "\005GlobalInfo" | | FMTID_ImageContents {56616400-C154-11CE-8553-00AA00A1F95B} | "\005ImageContents" | | FMTID_ImageInfo {56616500-C154-11CE-8553-00AA00A1F95B} | "\005ImageInfo" | All other FMTID values MUST be mapped to names as follows: 1. Start with the 128-bit [GUID](#Section_5ee5aa9d6b964e54a6bc6b1f562d616b) (Packet Version) representation of the FMTID and append 2 zero bits for a total of 130 bits. 2. Split the 130 bits into 26 groups of 5 consecutive bits each. 3. Map each group to a character as specified in the following table. Character mappings are case-insensitive, and an implementation MAY[\<8\>](#Appendix_A_8) convert characters to uppercase. | Bits | Character | Bits | Character | Bits | Character | Bits | Character | |-------|-----------|-------|-----------|-------|-----------|-------|-----------| | 00000 | a | 01000 | i | 10000 | q | 11000 | y | | 00001 | b | 01001 | j | 10001 | r | 11001 | z | | 00010 | c | 01010 | k | 10010 | s | 11010 | 0 | | 00011 | d | 01011 | l | 10011 | t | 11011 | 1 | | 00100 | e | 01100 | m | 10100 | u | 11100 | 2 | | 00101 | f | 01101 | n | 10101 | v | 11101 | 3 | | 00110 | g | 01110 | o | 10110 | w | 11110 | 4 | | 00111 | h | 01111 | p | 10111 | x | 11111 | 5 | 4. The stream or storage name is the character "\005" followed by the 26 characters obtained from this mapping. ## Standard Bindings The following sections specify standard bindings that can be used to associate property sets with a [**file**](#gt_a04c146a-de3b-4e4b-829f-a9e772f3fe25), so that property sets stored in this manner are discoverable to other implementations. An OLEPS implementation SHOULD support the [Compound File binding](#Section_89f4884730b24c3a835653ddfdda9fb7) for [**compound files**](#gt_4819d51b-789c-4d2a-ba56-88a48a87fae7). An implementation MAY[\<9\>](#Appendix_A_9) additionally support the [**alternate stream**](#gt_71cb9ca5-c721-4593-8498-c745d6a29b41) binding if the file system supports alternate streams, but this binding MUST NOT be used for compound files. ### Compound File Binding To associate a property set with a [**compound file**](#gt_4819d51b-789c-4d2a-ba56-88a48a87fae7), the [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) or storage representing the property set MUST be an [**element**](#gt_f633cdb5-cb63-4197-ad01-e7b02a745fdb) of the compound file's root storage and MUST have the standard name specified in section [2.23](#Section_e5484a833cc143a6afcf6558059fe36e). ### Alternate Stream Binding Some file systems provide a feature where a file can have alternate, named streams in addition to the main data stream of the file. For example, [**NTFS**](#gt_86f79a17-c0be-4937-8660-0cf6ce5ddc1a) has such a feature (see [\[MSDN-FileStreams\]](https://go.microsoft.com/fwlink/?LinkId=90537) for more information). The [**alternate stream**](#gt_71cb9ca5-c721-4593-8498-c745d6a29b41) binding enables property sets to be stored in these alternate streams, such that property sets can be associated with a file that is not a [**compound file**](#gt_4819d51b-789c-4d2a-ba56-88a48a87fae7). ### Control Stream A [**file**](#gt_a04c146a-de3b-4e4b-829f-a9e772f3fe25) that has one or more property sets associated with it through the [alternate stream binding](#Section_a7c45ae8f8f84db5ac0320c66f9634e9) MUST have a control stream, which is an [**alternate stream**](#gt_71cb9ca5-c721-4593-8498-c745d6a29b41) with the name "{4c8cc155-6c1e-11d1-8e41-00c04fb9386d}". This [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST contain the following packet. [TABLE] **Reserved1 (2 bytes):** MUST be set to zero, and nonzero values MUST be rejected. **Reserved2 (2 bytes):** MUST be set to zero, and MUST be ignored. **ApplicationState (4 bytes):** An application-provided value that MUST NOT be interpreted by the OLEPS implementation. If the application did not provide a value, it SHOULD be set to zero. **CLSID (16 bytes):** An application-provided value that MUST NOT be interpreted by the OLEPS implementation. If the application did not provide a value, it SHOULD be absent. ### Simple Property Set Stream A [**simple property set**](#gt_1caaa2c2-c703-4141-b99c-fe446f430f2c) MUST be represented by an [**alternate stream**](#gt_71cb9ca5-c721-4593-8498-c745d6a29b41) with the standard name specified in section [2.23](#Section_e5484a833cc143a6afcf6558059fe36e). This stream MUST contain a [PropertySetStream](#Section_6e65d6fa60444e23ae71d65d1e3b1249) packet. ### Non-Simple Property Set Storage A [**non-simple property set**](#gt_5756d395-5889-485e-9611-07904421f0f3) MUST be represented by an [**alternate stream**](#gt_71cb9ca5-c721-4593-8498-c745d6a29b41) with a name derived from the standard name specified in section [2.23](#Section_e5484a833cc143a6afcf6558059fe36e) according to the following ABNF [\[RFC4234\]](https://go.microsoft.com/fwlink/?LinkId=90462) syntax. 8. NonSimplePropertySetAlternateStreamName = "Docf\_" PropertySetStreamOrStorageName This stream's contents MUST be in the format of a [**compound file**](#gt_4819d51b-789c-4d2a-ba56-88a48a87fae7) (see [\[MS-CFB\]](%5bMS-CFB%5d.pdf#Section_53989ce47b054f8d829bd08d6148375b) for details). The root storage of this compound file MUST conform to the non-simple property set [**storage format**](#gt_47836016-72d2-4f37-9559-29df5393eaa6) as specified in section [2.22](#Section_83b0f8316adf48c58befb62e7ac1cc1e). ## Well-Known Property Set Formats The following sections specify the well-known [**property set formats**](#gt_662dbb07-0d00-4322-b305-fa99015511c4) [PropertyIdentifier](#Section_f7933d282cc44b36bc238861cbcd37c4) and [PropertyBag](#Section_9353494ccc624dccbda5db10c2f25a3e). ### SummaryInformation The SummaryInformation property set format, identified by FMTID_SummaryInformation ({F29F85E0-4FF9-1068-AB91-08002B27B3D9}), represents generic [**properties**](#gt_f930baab-25f1-4142-bced-5effc9f62d45) of a document. The properties specific to the SummaryInformation property set are specified in the following table. Except where otherwise stated, a SummaryInformation property set SHOULD have all of these properties, and SHOULD NOT have any other properties, except for the special properties specified in section [2.18](#Section_9389a815d71c4dd2b2722b3a8177f004). [TABLE] ### PropertyBag The PropertyBag [**property set format**](#gt_662dbb07-0d00-4322-b305-fa99015511c4), identified by FMTID_PropertyBag ({20001801-5DE6-11D1-8E38-00C04FB9386D}), is used in applications that persist an object as a property set, typically by saving state variables as properties. A PropertyBag [**property set's**](#gt_dc3c2e4a-3b46-4284-973e-cc0e362a3264) associated [**CLSID**](#gt_e433c806-6cb6-46a2-bb95-523df8818c99) SHOULD identify the application or component whose object is persisted in the property set. The properties contained in a PropertyBag property set are application-specific. # Structure Examples ## SummaryInformation Property Set The following table shows the binary contents of a stream representing a SummaryInformation Property Set. This is a [**simple property set**](#gt_1caaa2c2-c703-4141-b99c-fe446f430f2c), as the [SummaryInformation](#Section_f7933d282cc44b36bc238861cbcd37c4) format does not require support for stream and storage type properties. The name of this stream is "\005SummaryInformation", as specified in section [2.23](#Section_e5484a833cc143a6afcf6558059fe36e). [TABLE] The stream contains a [PropertySetStream](#Section_6e65d6fa60444e23ae71d65d1e3b1249) packet, with the following field values. Field offsets in this example are calculated from the beginning of the PropertySetStream packet. > **ByteOrder (2 bytes at offset 0):** 0xFFFE, as required. > > **Version (2 bytes at offset 2):** 0x0000, indicating that this is a version 0 property set. > > **SystemIdentifier (4 bytes at offset 4):** 0x00020006, which is the implementation-specific identifier written by Windows Vista operating system. > > **CLSID (16 bytes at offset 8):** GUID_NULL ({00000000-0000-0000-0000-000000000000}), the default value which indicates that the application that wrote the property set did not set the [**property set's**](#gt_dc3c2e4a-3b46-4284-973e-cc0e362a3264) [**CLSID**](#gt_e433c806-6cb6-46a2-bb95-523df8818c99). > > **NumPropertySets (4 bytes at offset 24):** 0x00000001, which indicates that there is only one property set in this stream (as required, since this is not the special case of FMTID_DocSummaryInformation/FMTID_UserDefinedProperties). > > **FMTID 0 (16 bytes at offset 28):** FMTID_SummaryInformation ({F29F85E0-4FF9-1068-AB91-08002B27B3D9}). > > **Offset 0 (4 bytes at offset 44):** 0x00000030, the offset from the beginning of this structure to the beginning of the field **PropertySet 0**. > > **FMTID 1 (0 bytes):** Absent, as required for a PropertySetStream with only one property set. > > **Offset 1 (0 bytes):** Absent, as required for a PropertySetStream with only one property set. > > **PropertySet 0 (396 bytes at offset 48):** A [PropertySet](#Section_aefcbddff2994f5ea9da65ce4ca55075) packet (consists of the remainder of the stream contents). > > The field **PropertySet 0** has the following subfield values: > > **Size (4 bytes at offset 48):** 0x0000018C. > > **NumProperties (4 bytes at offset 52):** 0x00000012 (decimal 18). > > **PropertyIdentifierAndOffset 0-17 (144 bytes total at offset 56):** This field includes the following sequence of 18 [PropertyIdentifierAndOffset](#Section_f59e6c94a0ae4d1b85d3f01c35779a22) packets. | PropertyIdentifier | Offset | |----|----| | 0x00000001 (property identifier for the [CodePage property](#Section_18a44a264a6748948db252a701f2473f)) | 0x00000098 | | PIDSI_TITLE (0x00000002) | 0x000000A0 | | PIDSI_SUBJECT (0x00000003) | 0x000000B8 | | PIDSI_AUTHOR (0x00000004) | 0x000000C4 | | PIDSI_KEYWORDS (0x00000005) | 0x000000D0 | | PIDSI_COMMENTS (0x00000006) | 0x000000DC | | PIDSI_TEMPLATE (0x00000007) | 0x000000E8 | | PIDSI_LASTAUTHOR (0x00000008) | 0x000000FC | | PIDSI_REVNUMBER (0x00000009) | 0x00000110 | | PIDSI_APPNAME (0x00000012) | 0x0000011C | | PIDSI_EDITTIME (0x0000000A) | 0x0000013C | | PIDSI_LASTPRINTED (0x0000000B) | 0x00000148 | | PIDSI_CREATE_DTM (0x0000000C) | 0x00000154 | | PIDSI_LASTSAVE_DTM (0x0000000D) | 0x00000160 | | PIDSI_PAGECOUNT (0x0000000E) | 0x0000016C | | PIDSI_WORDCOUNT (0x0000000F) | 0x00000174 | | PIDSI_CHARCOUNT (0x00000010) | 0x0000017C | | PIDSI_DOC_SECURITY (0x00000013) | 0x00000184 | > **Property 0-17 (252 bytes total at offset 200):** A sequence of 18 [TypedPropertyValue](#Section_f122b9d7e5cf4484846683f6fd94b3cc) packets, as described in the following sections (3.1.1 through [3.1.18](#Section_e45b4495a9b54c179f4d5b194c72a3e5)). > > **PropertySet 1:** Absent, as required for a PropertySetStream with only one property set. ### CodePage Property The CodePage property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x00000001 > > **Property offset:** 0x00000030 + 0x00000098 = 0x000000C8 (decimal 200) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 200):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_I2 (0x0002). > > **Padding (2 bytes at offset 202):** Set to zero, as required. > > **Value (4 bytes at offset 204):** The 2-byte signed integer 0x04E4 (decimal 1252) followed by 2 bytes of zero padding as required. Indicates that [CodePageString](#Section_a4c326115b7949658f5050639c138e16) packets in this property set are encoded with code page 1252 (Latin 1). ### PIDSI_TITLE The PIDSI_TITLE property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x00000002 > > **Property offset:** 0x00000030 + 0x000000A0 = 0x000000D0 (decimal 208) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 208):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_LPSTR (0x001E). > > **Padding (2 bytes at offset 210):** Set to zero, as required. > > **Value:** A [CodePageString](#Section_a4c326115b7949658f5050639c138e16) packet with the following subfields: > > **Size (4 bytes at offset 212):** 0x00000F (decimal 15). > > **Characters (16 bytes at offset 216):** The null-terminated sequence of 8-bit characters, "Joe's document", padded to a total length of 16 bytes. ### PIDSI_SUBJECT The PIDSI_SUBJECT property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x00000003 > > **Property offset:** 0x00000030 + 0x000000B8 = 0x000000E8 (decimal 232) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 232):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_LPSTR (0x001E). > > **Padding (2 bytes at offset 234):** Set to zero, as required. > > **Value:** A [CodePageString](#Section_a4c326115b7949658f5050639c138e16) packet with the following subfields: > > **Size (4 bytes at offset 236):** 0x000004. > > **Characters (4 bytes at offset 240):** The null-terminated sequence of 8-bit characters, "Job". ### PIDSI_AUTHOR The PIDSI_AUTHOR property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x00000004 > > **Property offset:** 0x00000030 + 0x000000C4 = 0x000000F4 (decimal 244) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 244):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_LPSTR (0x001E). > > **Padding (2 bytes at offset 246):** Set to zero, as required. > > **Value:** A [CodePageString](#Section_a4c326115b7949658f5050639c138e16) packet with the following subfields: > > **Size (4 bytes at offset 248):** 0x000004. > > **Characters (4 bytes at offset 252):** The null-terminated sequence of 8-bit characters, "Joe". ### PIDSI_KEYWORDS The PIDSI_KEYWORDS property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x00000005 > > **Property offset:** 0x00000030 + 0x000000D0 = 0x00000100 (decimal 256) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 256):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_LPSTR (0x001E). > > **Padding (2 bytes at offset 258):** Set to zero, as required. > > **Value:** A [CodePageString](#Section_a4c326115b7949658f5050639c138e16) packet with the following subfields: > > **Size (4 bytes at offset 260):** 0x000004. > > **Characters (4 bytes at offset 264):** A null-terminated sequence of 8-bit characters. The string itself consists entirely of null characters. ### PIDSI_COMMENTS The PIDSI_COMMENTS property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x00000006 > > **Property offset:** 0x00000030 + 0x000000DC = 0x0000010C (decimal 268) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 268):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_LPSTR (0x001E). > > **Padding (2 bytes at offset 270):** Set to zero, as required. > > **Value:** A [CodePageString](#Section_a4c326115b7949658f5050639c138e16) packet with the following subfields: > > **Size (4 bytes at offset 272):** 0x000004. > > **Characters (4 bytes at offset 276):** A null-terminated sequence of 8-bit characters. The string itself consists entirely of null characters. ### PIDSI_TEMPLATE The PIDSI_TEMPLATE property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x00000007 > > **Property offset:** 0x00000014 + 0x000000FC = 0x00000110 (decimal 272) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 280):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_LPSTR (0x001E). > > **Padding (2 bytes at offset 282):** Set to zero, as required. > > **Value:** A [CodePageString](#Section_a4c326115b7949658f5050639c138e16) packet with the following subfields: > > **Size (4 bytes at offset 284):** 0x0000000C (decimal 12). > > **Characters (12 bytes at offset 288):** The null-terminated sequence of 8-bit characters, "Normal.dotm". ### PIDSI_LASTAUTHOR The PIDSI_LASTAUTHOR property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x00000008 > > **Property offset:** 0x00000030 + 0x000000FC = 0x0000012C (decimal 300) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 300):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_LPSTR (0x001E). > > **Padding (2 bytes at offset 302):** Set to zero, as required. > > **Value:** A [CodePageString](#Section_a4c326115b7949658f5050639c138e16) packet with the following subfields: > > **Size (4 bytes at offset 304):** 0x00000A (decimal 10). > > **Characters (12 bytes at offset 308):** The null-terminated sequence of 8-bit characters, "Cornelius", padded to a total length of 12 bytes. ### PIDSI_REVNUMBER The PIDSI_REVNUMBER property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x00000009 > > **Property offset:** 0x00000030 + 0x00000110 = 0x00000140 (decimal 320) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 320):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_LPSTR (0x001E). > > **Padding (2 bytes at offset 322):** Set to zero, as required. > > **Value:** A [CodePageString](#Section_a4c326115b7949658f5050639c138e16) packet with the following subfields: > > **Size (4 bytes at offset 324):** 0x000004. > > **Characters (4 bytes at offset 328):** The null-terminated sequence of 8-bit characters, "66", followed by an additional null character. ### PIDSI_APPNAME The PIDSI_APPNAME property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x00000012 > > **Property offset:** 0x00000030 + 0x0000011C = 0x0000014C (decimal 332) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 332):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_LPSTR (0x001E). > > **Padding (2 bytes at offset 334):** Set to zero, as required. > > **Value:** A [CodePageString](#Section_a4c326115b7949658f5050639c138e16) packet with the following subfields: > > **Size (4 bytes at offset 336):** 0x000018. > > **Characters (24 bytes at offset 340):** The null-terminated sequence of 8-bit characters, "Microsoft Office Word", followed by two additional null characters. ### PIDSI_EDITTIME The PIDSI_EDITTIME property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x0000000A > > **Property offset:** 0x00000030 + 0x0000013C = 0x0000016C (decimal 364) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 364):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_FILETIME (0x0040). > > **Padding (2 bytes at offset 366):** Set to zero, as required. > > **Value (8 bytes at offset 368):** A [FILETIME](#Section_d8070a967f0c4235b4a1112876f2a419) packet that, when interpreted as a **64-bit unsigned integer**, as is appropriate for the **PIDSI_EDITTIME** property, has the value 0x00000042A2D96E00 (decimal 286,200,000,000). This value is in 100-nanosecond increments and is equal to 7 hours, 57 minutes. ### PIDSI_LASTPRINTED The PIDSI_LASTPRINTED property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x0000000B > > **Property offset:** 0x00000030 + 0x00000148 = 0x00000178 (decimal 376) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 376):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_FILETIME (0x0040). > > **Padding (2 bytes at offset 378):** Set to zero, as required. > > **Value (8 bytes at offset 380):** A [FILETIME](#Section_d8070a967f0c4235b4a1112876f2a419) packet with the value June 12, 2006 6:33 P.M. coordinated universal time (UTC). ### PIDSI_CREATE_DTM The PIDSI_CREATE_DTM property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x0000000C > > **Property offset:** 0x00000030 + 0x00000154 = 0x00000184 (decimal 388) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 388):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_FILETIME (0x0040). > > **Padding (2 bytes at offset 390):** Set to zero, as required. > > **Value (8 bytes at offset 392):** A [FILETIME](#Section_d8070a967f0c4235b4a1112876f2a419) packet with the value September 2, 2006 12:58 A.M. UTC. ### PIDSI_LASTSAVE_DTM The PIDSI_LASTSAVE_DTM property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x0000000D > > **Property offset:** 0x00000030 + 0x00000160 = 0x00000190 (decimal 400) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 400):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_FILETIME (0x0040). > > **Padding (2 bytes at offset 402):** Set to zero, as required. > > **Value (8 bytes at offset 404):** A [FILETIME](#Section_d8070a967f0c4235b4a1112876f2a419) packet with the value March 8, 2008 5:30 A.M. UTC. ### PIDSI_PAGECOUNT The PIDSI_PAGECOUNT property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x0000000E > > **Property offset:** 0x00000030 + 0x0000016C = 0x0000019C (decimal 412) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 412):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_I4 (0x0003). > > **Padding (2 bytes at offset 414):** Set to zero, as required. > > **Value (4 bytes at offset 416):** The 32-bit signed integer 0x0000000E (decimal 14). ### PIDSI_WORDCOUNT The PIDSI_WORDCOUNT property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x0000000F > > **Property offset:** 0x00000030 + 0x00000174 = 0x000001A4 (decimal 420) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 420):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_I4 (0x0003). > > **Padding (2 bytes at offset 422):** Set to zero, as required. > > **Value (4 bytes at offset 424):** The 32-bit signed integer 0x00000DE5 (decimal 3,557). ### PIDSI_CHARCOUNT The PIDSI_CHARCOUNT property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x00000010 > > **Property offset:** 0x00000030 + 0x0000017C = 0x000001AC (decimal 428) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 428):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_I4 (0x0003). > > **Padding (2 bytes at offset 430):** Set to zero, as required. > > **Value (4 bytes at offset 432):** The 32-bit signed integer 0x00004F38 (decimal 20,280). ### PIDSI_DOC_SECURITY The PIDSI_DOC_SECURITY property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x00000013 > > **Property offset:** 0x00000030 + 0x00000184 = 0x000001B4 (decimal 436) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 436):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_I4 (0x0003). > > **Padding (2 bytes at offset 438):** Set to zero, as required. > > **Value (4 bytes at offset 440):** The 32-bit signed integer 0x00000000, indicating that no access control is suggested by the application used to create the document. ## PropertyBag Property Set This section demonstrates the usage of some of the capabilities of OLEPS that are not used in [SummaryInformation](#Section_f7933d282cc44b36bc238861cbcd37c4) property sets (as described in section [3.1](#Section_3f9119dcfaa24bb9af955cf128fa5fbd)). The example is a [PropertyBag](#Section_9353494ccc624dccbda5db10c2f25a3e) property set, which an application has used to persist object state in an application-specific manner. The example property set uses the [**non-simple property set**](#gt_5756d395-5889-485e-9611-07904421f0f3) format and is stored using the [Alternate Stream Binding](#Section_a7c45ae8f8f84db5ac0320c66f9634e9). The [**file**](#gt_a04c146a-de3b-4e4b-829f-a9e772f3fe25) with which the property set is associated has two [**alternate streams**](#gt_71cb9ca5-c721-4593-8498-c745d6a29b41): "{4c8cc155-6c1e-11d1-8e41-00c04fb9386d}" and "Docf\_\005Bagaaqy23kudbhchAaq5u2chNd". ### Control Stream ("{4c8cc155-6c1e-11d1-8e41-00c04fb9386d}") The following table shows the binary contents of the control stream, which is required for a [**file**](#gt_a04c146a-de3b-4e4b-829f-a9e772f3fe25) containing one or more property sets stored using the [alternate stream binding](#Section_a7c45ae8f8f84db5ac0320c66f9634e9). This stream is identified by its name, "{4c8cc155-6c1e-11d1-8e41-00c04fb9386d}", as specified in section [2.24.3](#Section_f45612562877445c83d8aa91598462b6). [TABLE] > **Reserved1 (2 bytes at offset 0):** Set to zero, as required. > > **Reserved2 (2 bytes at offset 2):** Set to zero, as required. > > **ApplicationState (4 bytes at offset 4):** Set to zero, indicating that the application did not provide a value. > > **CLSID (0 bytes):** Absent, indicating that the application did not provide a value. ### PropertyBag Stream ("Docf\_\005Bagaaqy23kudbhchAaq5u2chNd") This stream contains the [non-simple property set storage format](#Section_83b0f8316adf48c58befb62e7ac1cc1e) representing the PropertyBag property set (as described in section [3.2](#Section_b8307f6f8e7040d0b09a3de2f4fd494b)). The [**FMTID**](#gt_bb4ffc07-754b-4e76-81e0-06686d942c9a) of the property set, FMTID_PropertyBag ({20001801-5DE6-11D1-8E38-00C04FB9386D}), as well as the fact that it is a [**non-simple property set**](#gt_5756d395-5889-485e-9611-07904421f0f3), are indicated by its name, "Docf\_\005Bagaaqy23kudbhchAaq5u2chNd", as specified in section [2.24.5](#Section_d56ee70751914fa5b66928259cac03a2). The [**stream's**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) contents are in the format of a [**compound file**](#gt_4819d51b-789c-4d2a-ba56-88a48a87fae7) (see [\[MS-CFB\]](%5bMS-CFB%5d.pdf#Section_53989ce47b054f8d829bd08d6148375b) for details). For brevity, the binary contents of this stream are omitted here. The compound file stored in this [**alternate stream**](#gt_71cb9ca5-c721-4593-8498-c745d6a29b41) represents a storage with the following elements: - A stream named "CONTENTS" - A stream named "prop6" - A storage named "prop12" The associated [**CLSID**](#gt_e433c806-6cb6-46a2-bb95-523df8818c99) of the root storage is {994BFF53-DDF9-42AD-A56A-FFEA3617AC16}, which, as specified in section 2.22, is the associated CLSID of the property set. This value was set by the application and is not recognized by OLEPS implementations. #### "CONTENTS" Stream The following table shows the binary contents of the "CONTENTS" stream. [TABLE] The stream contains a [PropertySetStream](#Section_6e65d6fa60444e23ae71d65d1e3b1249) packet, with the following field values: **Note**  Field offsets in this example are calculated from the beginning of the PropertySetStream packet. > **ByteOrder (2 bytes at offset 0):** 0xFFFE, as required. > > **Version (2 bytes at offset 2):** 0x0001, indicating that this is a version 1 property set. This value was set by the OLEPS implementation, because the application used the following features not supported by version 0 property sets: - A property of type VT_ARRAY \| VT_I1 (0x2010). - The [Behavior property](#Section_1149ab6d06bc4044940de6681c1ce4e1). > **SystemIdentifier (4 bytes at offset 4):** 0x00020006, which is the operating system identifier.[\<10\>](#Appendix_A_10) > > **CLSID (16 bytes at offset 8):** {994BFF53-DDF9-42AD-A56A-FFEA3617AC16}. This is the same value as the associated [**CLSID**](#gt_e433c806-6cb6-46a2-bb95-523df8818c99) of the storage in which this property set is stored. > > **NumPropertySets (4 bytes at offset 24):** 0x00000001, which indicates that there is only one property set in this stream (as required, because this is not the special case of FMTID_DocSummaryInformation/FMTID_UserDefinedProperties). > > **FMTID 0 (16 bytes at offset 28):** FMTID_PropertyBag ({20001801-5DE6-11D1-8E38-00C04FB9386D}). > > **Offset 0 (4 bytes at offset 44):** 0x00000030, the offset from the beginning of this structure to the beginning of the field **PropertySet 0**. > > **FMTID 1 (0 bytes):** Absent, as required for a PropertySetStream with only one property set. > > **Offset 1 (0 bytes):** Absent, as required for a PropertySetStream with only one property set. > > **PropertySet 0 (396 bytes at offset 48):** A [PropertySet](#Section_aefcbddff2994f5ea9da65ce4ca55075) packet (consists of the remainder of the stream contents). > > The field **PropertySet 0** has the following subfield values: > > **Size (4 bytes at offset 48):** 0x000001DC (decimal 496). > > **NumProperties (4 bytes at offset 52):** 0x0000000A (decimal 10). > > **PropertyIdentifierAndOffset 0–9 (80 bytes total at offset 56):** This consists of the following sequence of [PropertyIdentifierAndOffset](#Section_f59e6c94a0ae4d1b85d3f01c35779a22) packets. | PropertyIdentifier | Offset | |----|----| | 0x00000001 (property identifier for the [CodePage property](#Section_b89107367f4a469a9644aed68a71d7d1)) | 0x00000058 | | 0x80000000 (property identifier for the [Locale property](#Section_bb452c0779f746e0bfb7122c347cc5c8)) | 0x00000060 | | 0x80000001 (property identifier for the Behavior property) | 0x00000068 | | 0x00000000 (property identifier for the [Dictionary property](#Section_4177a4bc554749fea4d94767350fd9cf)) | 0x00000070 | | 0x00000004 | 0x00000138 | | 0x00000006 | 0x0000014C | | 0x00000007 | 0x00000170 | | 0x0000000c | 0x0000017C | | 0x00000027 | 0x00000194 | | 0x00000092 | 0x000001C0 | > **Property 0–9 (496 bytes total at offset 136):** A sequence of 10 [TypedPropertyValue](#Section_f122b9d7e5cf4484846683f6fd94b3cc) packets, except the Dictionary property, which is a [Dictionary](#Section_c1947489dff74274bed7a8c5eefc6853) packet, as described in section 3.2.2.1.4. ##### CodePage The CodePage property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x00000001 > > **Property offset:** 0x00000030 + 0x00000058 = 0x00000088 (decimal 136) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 136):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_I2 (0x0002). > > **Padding (2 bytes at offset 138):** Set to zero, as required. > > **Value (4 bytes at offset 140):** The 2-byte signed integer 0x04B0 (decimal 1200) followed by 2 bytes of zero padding as required. This value is CP_WINUNICODE, which indicates that [CodePageString](#Section_a4c326115b7949658f5050639c138e16) packets in this property set are encoded as arrays of 16-bit [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters. ##### Locale The Locale property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x80000000 > > **Property offset:** 0x00000030 + 0x00000060 = 0x00000090 (decimal 144) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 144):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_UI4 (0x0013). > > **Padding (2 bytes at offset 146):** Set to zero, as required. > > **Value (4 bytes at offset 148):** The 4-byte unsigned integer 0x08090000. This value encodes the Language ID 0x0809 (en-GB) and Sort ID 0x0 (SORT_DEFAULT), as specified in [\[MS-LCID\]](%5bMS-LCID%5d.pdf#Section_70feba9f294e491eb6eb56532684c37f) section 2.2. ##### Behavior The Behavior property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x80000001 > > **Property offset:** 0x00000030 + 0x00000068 = 0x00000098 (decimal 152) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 152):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_UI4 (0x0013). > > **Padding (2 bytes at offset 154):** Set to zero, as required. > > **Value (4 bytes at offset 156):** The 4-byte unsigned integer 0x00000001, indicating that property names are case-sensitive. ##### Dictionary The Dictionary property is an instance of the **Dictionary** structure defined in section [2.17](#Section_99127b7fc440469791a4c853086d6b33). > **Property identifier:** 0x00000000 > > **Property offset:** 0x00000030 + 0x00000070 = 0x000000A0 (decimal 160) The following table shows the binary contents of the structure representing the property. [TABLE] > **NumEntries (4 bytes at offset 160):** 0x00000006. > > **Entry 0–5 (196 bytes total at offset 164):** A sequence of six [DictionaryEntry](#Section_333959a3a9994eca862748a224e63e77) packets as described in sections [3.2.2.1.4.1](#Section_be6c51af08c64f6db769d0c41e578880) through [3.2.2.1.4.6](#Section_187e913d8ed04d9d8d05caf250b34cff). The Dictionary property set assigns [**property names**](#gt_dcd670df-c295-466f-b681-d7d91014040a) to each of its properties (except the [Special properties](#Section_9389a815d71c4dd2b2722b3a8177f004), which cannot have property names). | PropertyIdentifier | Name | Section | |----|----|----| | 0x00000004 | DisplayColour | Dictionary Entry 0 (section 3.2.2.1.4.1) | | 0x00000006 | MyStream | Dictionary Entry 1 (section [3.2.2.1.4.2](#Section_ccf935f24a1541cfa965e24392905959)) | | 0x00000007 | Price(GBP) | Dictionary Entry 2 (section [3.2.2.1.4.3](#Section_ae8df321a51747eba964eb1ac8b5ad56)) | | 0x0000000c | MyStorage | Dictionary Entry 3 (section [3.2.2.1.4.4](#Section_2284360a4dc14919b8c4d92f1ce86eed)) | | 0x00000027 | CaseSensitive | Dictionary Entry 4 (section [3.2.2.1.4.5](#Section_284652dddfb54802974e6e20b148e009)) | | 0x00000092 | CASESENSITIVE | Dictionary Entry 5 (section 3.2.2.1.4.6) | Note that two of these properties have names that are equal when compared in a manner that ignores case sensitivity ("CaseSensitive" and "CASESENSITIVE"). This equality is valid because the Dictionary [**property set's**](#gt_dc3c2e4a-3b46-4284-973e-cc0e362a3264) [Behavior property](#Section_1149ab6d06bc4044940de6681c1ce4e1) has the value 0x00000001; otherwise, this would be invalid. ###### Dictionary Entry 0 Entry 0 of the [Dictionary (section 3.2.2.1.4)](#Section_c1947489dff74274bed7a8c5eefc6853) property is an instance of the **DictionaryEntry** structure defined in section [2.16](#Section_333959a3a9994eca862748a224e63e77). > **Entry offset:** 0x000000A4 (decimal 164) The following table shows the binary contents of the structure representing the entry. [TABLE] > **PropertyIdentifier (4 bytes at offset 164):** 0x00000004 > > **Length (4 bytes at offset 168):** 0x0000000E (decimal 14). > > **Name (28 bytes at offset 172):** The null-terminated sequence of 16-bit Unicode characters, "DisplayColour". ###### Dictionary Entry 1 Entry 1 of the [Dictionary (section 3.2.2.1.4)](#Section_c1947489dff74274bed7a8c5eefc6853) property is an instance of the **DictionaryEntry** structure defined in section [2.16](#Section_333959a3a9994eca862748a224e63e77). > **Entry offset:** 0x000000C8 (decimal 200) The following table shows the binary contents of the structure representing the entry. [TABLE] > **PropertyIdentifier (4 bytes at offset 200):** 0x00000006 > > **Length (4 bytes at offset 204):** 0x00000009. > > **Name (20 bytes at offset 208):** The null-terminated sequence of 16-bit Unicode characters, "MyStream", padded with zeroes to a multiple of 4 bytes. ###### Dictionary Entry 2 Entry 2 of the [Dictionary (section 3.2.2.1.4)](#Section_c1947489dff74274bed7a8c5eefc6853) property is an instance of the **DictionaryEntry** structure defined in section [2.16](#Section_333959a3a9994eca862748a224e63e77). > **Entry offset:** 0x000000E4 (decimal 228) The following table shows the binary contents of the structure representing the entry. [TABLE] > **PropertyIdentifier (4 bytes at offset 228):** 0x00000007 > > **Length (4 bytes at offset 232):** 0x0000000B (decimal 11). > > **Name (24 bytes at offset 236):** The null-terminated sequence of 16-bit Unicode characters, "Price(GBP)", padded with zeroes to a multiple of 4 bytes. ###### Dictionary Entry 3 Entry 3 of the [Dictionary (section 3.2.2.1.4)](#Section_c1947489dff74274bed7a8c5eefc6853) property is an instance of the **DictionaryEntry** structure defined in section [2.16](#Section_333959a3a9994eca862748a224e63e77). > **Entry offset:** 0x00000104 (decimal 260) The following table shows the binary contents of the structure representing the entry. [TABLE] > **PropertyIdentifier (4 bytes at offset 260):** 0x0000000C (decimal 12). > > **Length (4 bytes at offset 264):** 0x0000000A (decimal 10). > > **Name (20 bytes at offset 268):** The null-terminated sequence of 16-bit Unicode characters, "MyStorage". ###### Dictionary Entry 4 Entry 4 of the [Dictionary (section 3.2.2.1.4)](#Section_c1947489dff74274bed7a8c5eefc6853) property is an instance of the **DictionaryEntry** structure defined in section [2.16](#Section_333959a3a9994eca862748a224e63e77). > **Entry offset:** 0x000000A4 (decimal 288) The following table shows the binary contents of the structure representing the entry. [TABLE] > **PropertyIdentifier (4 bytes at offset 288):** 0x00000027 > > **Length (4 bytes at offset 292):** 0x0000000E (decimal 14). > > **Name (28 bytes at offset 296):** The null-terminated sequence of 16-bit Unicode characters, "CaseSensitive". ###### Dictionary Entry 5 Entry 5 of the [Dictionary (section 3.2.2.1.4)](#Section_c1947489dff74274bed7a8c5eefc6853) property is an instance of the **DictionaryEntry** structure defined in section [2.16](#Section_333959a3a9994eca862748a224e63e77). > **Entry offset:** 0x00000144 (decimal 324) The following table shows the binary contents of the structure representing the entry. [TABLE] > **PropertyIdentifier (4 bytes at offset 324):** 0x00000092 (decimal 146). > > **Length (4 bytes at offset 328):** 0x0000000E (decimal 14). > > **Name (28 bytes at offset 332):** The null-terminated sequence of 16-bit Unicode characters, "CASESENSITIVE". ##### DisplayColour The DisplayColour property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x00000004 > > **Property offset:** 0x00000030 + 0x00000138 = 0x00000168 (decimal 360) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 360):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_BSTR (0x0008). > > **Padding (2 bytes at offset 362):** Set to zero, as required. > > **Value:** Value A [CodePageString](#Section_a4c326115b7949658f5050639c138e16) packet with the following subfields: > > **Size (4 bytes at offset 364):** 0x00000A (decimal 10). > > **Characters (12 bytes at offset 368):** The null-terminated sequence of 16-bit [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters, "Grey", padded with zeroes to a multiple of 4 bytes. ##### MyStream The MyStream property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x00000006 > > **Property offset:** 0x00000030 + 0x0000014C = 0x0000017C (decimal 380) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 380):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_VERSIONED_STREAM (0x0049). > > **Padding (2 bytes at offset 382):** Set to zero, as required. > > **Value:** A [VersionedStream](#Section_7c6776d18f2c4693aa7e281bcbc61a1f) packet with the following subfields: > > **VersionGuid (16 bytes at offset 384):** {F99584CA-CA23-470B-8394-220177907AAD}. This is an application-specific value that has no meaning to OLEPS implementations. > > **Size (4 bytes at offset 400):** 0x0000000C (decimal 12). > > **Characters (12 bytes at offset 404):** The null-terminated sequence of 16-bit [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters, "prop6". Note that the TypedPropertyValue packet representing this property does not contain the complete property value. The remainder of the property value is contained in the stream, "[prop6](#Section_7b86c5e9a6e14e2e93b14e51b2c90eea)". ##### Price(GBP) The Price(GBP) property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x00000007 > > **Property offset:** 0x00000030 + 0x00000170 = 0x000001A0 (decimal 416) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 416):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_CY (0x0006). > > **Padding (2 bytes at offset 418):** Set to zero, as required. > > **Value (8 bytes at offset 420):** A [CURRENCY](#Section_fb1fc39313a945399bbb9c696434c6e0) packet with the value 133.1200 (presumably £133.12 based on the name of the property). ##### MyStorage The MyStorage property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x0000000C > > **Property offset:** 0x00000030 + 0x0000017C = 0x000001AC (decimal 428) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 428):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_STORED_OBJECT (0x0045). > > **Padding (2 bytes at offset 430):** Set to zero, as required. > > **Value:** An [IndirectPropertyName](#Section_e3bdb60847564a0cb2fd15b7eee52905) packet with the following subfields: > > **Size (4 bytes at offset 432):** 0x0000000E (decimal 14). > > **Characters (16 bytes at offset 436):** The null-terminated sequence of 16-bit [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters, "prop12", padded with zeroes to a multiple of 4 bytes. Note that the TypedPropertyValue packet representing this property does not contain the property value. The property value is contained in the storage, "prop12". ##### CaseSensitive Mixed Case The CaseSensitive property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x00000027 > > **Property offset:** 0x00000030 + 0x00000194 = 0x000001C4 (decimal 452) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 452):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_ARRAY \| VT_I1 (0x2010). > > **Padding (2 bytes at offset 454):** Set to zero, as required. > > **Value:** An [ArrayHeader](#Section_e74a8869440b43a4985c70b850b8aeed) followed by a sequence of 1-byte signed integers, followed by zero padding to a total length that is a multiple of 4 bytes. The ArrayHeader has the following subfields: > > **Type (4 bytes at offset 456):** 0x00000010, the value obtained by clearing the VT_ARRAY (0x2000) bit of the **Type** field. > > **NumDimensions (4 bytes at offset 460):** 0x00000002. > > **Dimension 0-1 (16 bytes total at offset 464):** A sequence of [ArrayDimension](#Section_7db5c301aacb4f45b95646ee7010bf90) packets described as follows. [TABLE] > **Size (4 bytes at offset 464):** 0x00000003. > > **IndexOffset (4 bytes at offset 468):** 0xFFFFFFFF (decimal -1). [TABLE] > **Size (4 bytes at offset 472):** 0x00000005. > > **IndexOffset (4 bytes at offset 476):** 0x00000000. > > **Scalar values 0-14 (16 bytes total at offset 480):** The total number of scalar values in the array property is 3×5 = 15. > > A sequence of 15 1-byte signed integers, padded with zeroes to a multiple of 4 bytes. The arrangement of the integer sequence in the array is shown in the following table. [TABLE] ##### CASESENSITIVE All Uppercase The CASESENSITIVE All Uppercase property is an instance of the **TypedPropertyValue** structure defined in section [2.15](#Section_f122b9d7e5cf4484846683f6fd94b3cc). > **Property identifier:** 0x00000092 > > **Property offset:** 0x00000030 + 0x000001C0 = 0x000001F0 (decimal 496) The following table shows the binary contents of the structure representing the property. [TABLE] > **Type (2 bytes at offset 496):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_VECTOR \| VT_VARIANT (0x100C). > > **Padding (2 bytes at offset 498):** Set to zero, as required. > > **Value:** A [VectorHeader](#Section_7db5c301aacb4f45b95646ee7010bf90) followed by a sequence of TypedPropertyValue packets. The VectorHeader has the following subfield: > > **Length (4 bytes at offset 500):** 0x00000002. > > **Scalar values 0-1 (20 bytes total at offset 504):** This includes the following sequence of TypedPropertyValue packets. [TABLE] > **Type (2 bytes at offset 504):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_UI1 (0x0011). > > **Padding (2 bytes at offset 506):** Set to zero, as required. > > **Value (4 bytes at offset 508):** The 1-byte unsigned integer 0xA9 (decimal 169), padded with zeroes to a multiple of 4 bytes. [TABLE] > **Type (2 bytes at offset 512):** The type of property represented in the packet; the type is identified as the **PropertyType** enumeration value VT_I8 (0x0014). > > **Padding (2 bytes at offset 514):** Set to zero, as required. > > **Value (8 bytes at offset 516):** The 8-byte signed integer 0x9C10223B997600A9 (decimal -7201218164792360791). #### "prop6" Stream This stream contains the stream portion of the VT_VERSIONED_STREAM property, "MyStream" ([PropertyIdentifier](#Section_04727953c1744d0180aeb38b15d7068a) 0x00000006). For brevity, the contents of the stream are omitted here. #### "prop12" Storage This storage contains the value of the VT_STORED_OBJECT property, "MyStorage" ([PropertyIdentifier](#Section_04727953c1744d0180aeb38b15d7068a) 0x0000000C). This storage contains an application-specific representation of an object. For brevity, the contents of the storage are omitted here. # Security Considerations None. # Appendix A: Product Behavior The information in this specification is applicable to the following Microsoft products or supplemental software. References to product versions include updates to those products. - Windows NT 4.0 operating system   - Windows 2000 operating system - Windows XP operating system - Windows Server 2003 operating system - Windows Vista operating system - Windows Server 2008 operating system - Windows 7 operating system - Windows Server 2008 R2 operating system - Windows 8 operating system - Windows Server 2012 operating system - Windows 8.1 operating system - Windows Server 2012 R2 operating system - Windows 10 operating system - Windows Server 2016 operating system - Windows Server operating system - Windows Server 2019 operating system   - Windows Server 2022 operating system - Windows 11 operating system - Windows Server 2025 operating system Exceptions, if any, are noted in this section. If an update version, service pack or Knowledge Base (KB) number appears with a product name, the behavior changed in that update. The new behavior also applies to subsequent updates unless otherwise specified. If a product edition appears with the product version, behavior is different in that product edition. Unless otherwise specified, any statement of optional behavior in this specification that is prescribed using the terms "SHOULD" or "SHOULD NOT" implies product behavior in accordance with the SHOULD or SHOULD NOT prescription. Unless otherwise specified, the term "MAY" implies that the product does not follow the prescription. [\<1\> Section 2.5](#Appendix_A_Target_1): Windows presents properties with [PropertySet](#Section_aefcbddff2994f5ea9da65ce4ca55075) VT_LPSTR (0x001E) to applications as null-terminated string values such that the application cannot reliably detect the presence of trailing null characters or any characters following the first embedded null character. Properties with [PropertyType](#Section_2a4589eb9a234a8badbd3e368233c099) VT_BSTR (0x0008) are presented to the application as a value of type **BSTR** (for more information, see [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) section 2.2.5), which is an explicitly-sized string type, and in which an application can detect these characters. Identical behavior also applies to scalar values of type VT_LPSTR or VT_BSTR, respectively, when these values are part of a vector or array property type. [\<2\> Section 2.18.2](#Appendix_A_Target_2): Windows enables applications creating a [**property set**](#gt_dc3c2e4a-3b46-4284-973e-cc0e362a3264) to select whether a property set is [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8), in which case the [CodePage property](#Section_b89107367f4a469a9644aed68a71d7d1) is CP_WINUNICODE (0x04B0). Alternatively, it can select ANSI, in which case the CodePage property is the current ANSI code page identifier for the system. [\<3\> Section 2.18.3](#Appendix_A_Target_3): Windows always selects the current user's default locale for the [Locale property](#Section_bb452c0779f746e0bfb7122c347cc5c8). [\<4\> Section 2.21](#Appendix_A_Target_4): Different versions of Windows limit the size of a [PropertySetStream](#Section_6e65d6fa60444e23ae71d65d1e3b1249) packet as follows. | Windows version | Limit (bytes) | |----|----| | Windows NT operating system | 262,144 | | Windows 2000 | 1,048,576 | | Windows XP | 1,048,576 | | Windows XP operating system Service Pack 2 (SP2) | 1,048,576 | | Windows XP operating system Service Pack 3 (SP3) | 2,097,152 | | Windows Server 2003 operating system with Service Pack 1 (SP1) | 1,048,576 | | Windows Server 2003 operating system with Service Pack 2 (SP2) | 2,097,152 | | Windows Vista and later | 2,097,152 | | Windows Server 2008 and later | 2,097,152 | [\<5\> Section 2.21](#Appendix_A_Target_5): Windows NT does not support version 1 property sets. [\<6\> Section 2.21](#Appendix_A_Target_6): Different versions of Windows write the **SystemIdentifier** field as follows. | Windows version | SystemIdentifier | |-------------------------------|------------------| | Windows | 0x00020004 | | Windows 2000 | 0x00020005 | | Windows XP | 0x00020105 | | Windows Server 2003 | 0x00020205 | | Windows Vista and later | 0x00020006 | | Windows Server 2008 and later | 0x00020006 | [\<7\> Section 2.23](#Appendix_A_Target_7): Windows provides a mechanism for applications to store property sets in an arbitrary application-provided [**stream container**](#gt_58ee6849-9bfd-4d97-aa22-4dbb6fb36e06) or [**storage container**](#gt_45e690de-dbe5-49a6-9317-ae4defe379dc). [\<8\> Section 2.23](#Appendix_A_Target_8): Windows converts the mapped characters in positions 0, 8, 16, and 24 to uppercase. [\<9\> Section 2.24](#Appendix_A_Target_9): Windows NT does not support the [**alternate stream**](#gt_71cb9ca5-c721-4593-8498-c745d6a29b41) binding for files on [**NTFS**](#gt_86f79a17-c0be-4937-8660-0cf6ce5ddc1a) volumes. [\<10\> Section 3.2.2.1](#Appendix_A_Target_10): Different versions of Windows write the **SystemIdentifier** field as follows. | Windows version | SystemIdentifier | |-----------------|------------------| | Windows Vista | 0x00020006 | | Windows 7 | 0x00020106 | | Windows 8 | 0x00020206 | | Windows 8.1 | 0x00020306 | | Windows 10 | 0x0002000a | # Change Tracking This section identifies changes that were made to this document since the last release. Changes are classified as Major, Minor, or None. The revision class **Major** means that the technical content in the document was significantly revised. Major changes affect protocol interoperability or implementation. Examples of major changes are: - A document revision that incorporates changes to interoperability requirements. - A document revision that captures changes to protocol functionality. The revision class **Minor** means that the meaning of the technical content was clarified. Minor changes do not affect protocol interoperability or implementation. Examples of minor changes are updates to clarify ambiguity at the sentence, paragraph, or table level. The revision class **None** means that no new technical changes were introduced. Minor editorial and formatting changes may have been made, but the relevant technical content is identical to the last released version. The changes made to this document are listed in the following table. For more information, please contact . | Section | Description | Revision class | |----|----|----| | [5](#Section_0ad7dbc8a93d4b71972cd5f4ff01d0cf) Appendix A: Product Behavior | Added Windows Server 2025 to the list of applicable products. | Major | # Index A [Applicability](#applicability-statement) 9 [Array property types](#vector-and-array-property-types) 20 [ArrayDimension packet](#arraydimension) 21 [ArrayHeader packet](#arrayheader) 22 B [Bindings - standard](#standard-bindings) 33 [BLOB packet](#blob) 18 C [Change tracking](#change-tracking) 66 [ClipboardData packet](#clipboarddata) 18 [CodePageString packet](#codepagestring) 16 [Common data types and fields](#structures) 11 [ControlStream packet](#control-stream) 33 [CURRENCY packet](#currency-packet-version) 16 D [Data types and fields - common](#structures) 11 [DATE packet](#date-packet-version) 16 [DECIMAL packet](#decimal-packet-version) 17 Details [common data types and fields](#structures) 11 [Dictionary packet](#dictionary) 26 [DictionaryEntry packet](#dictionaryentry) 26 E Examples [PropertyBag Property Set](#propertybag-property-set) 48 [SummaryInformation Property Set](#summaryinformation-property-set) 37 F [Fields - vendor-extensible](#vendor-extensible-fields) 10 [FILETIME packet](#filetime-packet-version) 17 [Formats - property set](#well-known-property-set-formats) 34 G [Glossary](#glossary) 6 [GUID packet](#guid-packet-version) 19 I [Implementer - security considerations](#security-considerations) 62 [Informative references](#informative-references) 8 [Introduction](#introduction) 6 L [Localization](#versioning-and-localization) 9 N [Normative references](#normative-references) 7 O [Overview (synopsis)](#overview) 8 P [Product behavior](#appendix-a-product-behavior) 63 [Property set formats - well-known](#well-known-property-set-formats) 34 Property types [array](#vector-and-array-property-types) 20 [vector](#vector-and-array-property-types) 20 [PropertyBag property set](#propertybag-property-set) 48 [PropertyBag Property Set example](#propertybag-property-set) 48 [PropertyIdentifierAndOffset packet](#propertyidentifierandoffset) 28 [PropertySet packet](#propertyset) 28 [PropertySetStream packet](#propertysetstream) 29 R [References](#references) 7 [informative](#informative-references) 8 [normative](#normative-references) 7 [Relationship to protocols and other structures](#relationship-to-protocols-and-other-structures) 9 S [Security](#security-considerations) 62 [Security - implementer considerations](#security-considerations) 62 [Special properties](#special-properties) 27 [Standard bindings](#standard-bindings) 33 [Structures](#structures) 11 [overview](#structures) 11 [SummaryInformation property set](#summaryinformation-property-set) 37 [SummaryInformation Property Set example](#summaryinformation-property-set) 37 T [Tracking changes](#change-tracking) 66 [TypedPropertyValue packet](#typedpropertyvalue) 22 U [UnicodeString packet](#unicodestring) 17 V [Vector property types](#vector-and-array-property-types) 20 [VectorHeader packet](#vectorheader) 21 [Vendor-extensible fields](#vendor-extensible-fields) 10 [VersionedStream packet](#versionedstream) 19 [Versioning](#versioning-and-localization) 9 W [Well-known property set formats](#well-known-property-set-formats) 34