**\[MS-OSHARED\]:** **Office Common Data Types and Objects 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 | |----|----|----|----| | 6/27/2008 | 1.0 | New | Initial Availability | | 1/16/2009 | 1.01 | Editorial | Revised and edited the technical content | | 7/13/2009 | 1.02 | Major | Changes made for template compliance | | 8/28/2009 | 1.03 | Editorial | Revised and edited the technical content | | 11/6/2009 | 1.04 | Editorial | Revised and edited the technical content | | 2/19/2010 | 2.0 | Editorial | Revised and edited the technical content | | 3/31/2010 | 2.01 | Editorial | Revised and edited the technical content | | 4/30/2010 | 2.02 | Editorial | Revised and edited the technical content | | 6/7/2010 | 2.03 | Editorial | Revised and edited the technical content | | 6/29/2010 | 2.04 | Editorial | Changed language and formatting in the technical content. | | 7/23/2010 | 2.04 | None | No changes to the meaning, language, or formatting of the technical content. | | 9/27/2010 | 2.04 | None | No changes to the meaning, language, or formatting of the technical content. | | 11/15/2010 | 2.04 | None | No changes to the meaning, language, or formatting of the technical content. | | 12/17/2010 | 2.04 | None | No changes to the meaning, language, or formatting of the technical content. | | 3/18/2011 | 2.04 | None | No changes to the meaning, language, or formatting of the technical content. | | 6/10/2011 | 2.04 | None | No changes to the meaning, language, or formatting of the technical content. | | 1/20/2012 | 2.5 | Minor | Clarified the meaning of the technical content. | | 4/11/2012 | 2.5 | None | No changes to the meaning, language, or formatting of the technical content. | | 7/16/2012 | 2.6 | Minor | Clarified the meaning of the technical content. | | 10/8/2012 | 2.6 | None | No changes to the meaning, language, or formatting of the technical content. | | 2/11/2013 | 2.6 | None | No changes to the meaning, language, or formatting of the technical content. | | 7/30/2013 | 2.6 | None | No changes to the meaning, language, or formatting of the technical content. | | 11/18/2013 | 2.6 | None | No changes to the meaning, language, or formatting of the technical content. | | 2/10/2014 | 2.6 | None | No changes to the meaning, language, or formatting of the technical content. | | 4/30/2014 | 2.7 | Minor | Clarified the meaning of the technical content. | | 7/31/2014 | 2.8 | Minor | Clarified the meaning of the technical content. | | 10/30/2014 | 2.9 | Minor | Clarified the meaning of the technical content. | | 3/16/2015 | 3.0 | Major | Significantly changed the technical content. | | 9/4/2015 | 4.0 | Major | Significantly changed the technical content. | | 7/15/2016 | 4.0 | None | No changes to the meaning, language, or formatting of the technical content. | | 9/14/2016 | 4.0 | None | No changes to the meaning, language, or formatting of the technical content. | | 12/15/2016 | 4.1 | Minor | Clarified the meaning of the technical content. | | 6/20/2017 | 4.1 | None | No changes to the meaning, language, or formatting of the technical content. | | 9/19/2017 | 4.2 | Minor | Clarified the meaning of the technical content. | | 12/12/2017 | 4.3 | Minor | Clarified the meaning of the technical content. | | 4/27/2018 | 5.0 | Major | Significantly changed the technical content. | | 8/28/2018 | 6.0 | Major | Significantly changed the technical content. | | 12/11/2018 | 7.0 | Major | Significantly changed the technical content. | | 3/19/2019 | 7.0 | None | No changes to the meaning, language, or formatting of the technical content. | | 2/19/2020 | 7.1 | Minor | Clarified the meaning of the technical content. | | 4/22/2021 | 8.0 | Major | Significantly changed the technical content. | | 8/17/2021 | 9.0 | Major | Significantly changed the technical content. | | 4/16/2024 | 10.0 | Major | Significantly changed the technical content. | | 8/20/2024 | 11.0 | Major | Significantly changed the technical content. | | 11/13/2025 | 11.1 | Minor | Clarified the meaning of the technical content. | Table of Contents [1 Introduction [9](#introduction)](#introduction) [1.1 Glossary [9](#glossary)](#glossary) [1.2 References [15](#references)](#references) [1.2.1 Normative References [15](#normative-references)](#normative-references) [1.2.2 Informative References [17](#informative-references)](#informative-references) [1.3 Structure Overview (Synopsis) [17](#structure-overview-synopsis)](#structure-overview-synopsis) [1.3.1 Toolbar Customization [17](#toolbar-customization)](#toolbar-customization) [1.3.2 Property Set Storage [19](#_Toc213739256)](#_Toc213739256) [1.3.3 RefEdit Control [20](#_Toc213739257)](#_Toc213739257) [1.3.4 Visual Basic for Applications Digital Signature [20](#_Toc213739258)](#_Toc213739258) [1.3.5 Byte Ordering [22](#_Toc213739259)](#_Toc213739259) [1.4 Relationship to Protocols and Other Structures [22](#relationship-to-protocols-and-other-structures)](#relationship-to-protocols-and-other-structures) [1.4.1 Toolbar Customization [22](#_Toc213739261)](#_Toc213739261) [1.4.2 Property Set Storage [23](#ms-ctdoc-for-the-persistence-format-for-word-processing-documents.ms-ctxls-for-the-persistence-format-for-spreadsheet-toolbar-customization-structures-defined-in-this-document.-property-set-storage)](#ms-ctdoc-for-the-persistence-format-for-word-processing-documents.ms-ctxls-for-the-persistence-format-for-spreadsheet-toolbar-customization-structures-defined-in-this-document.-property-set-storage) [1.4.3 Visual Basic for Applications Digital Signature [23](#_Toc213739263)](#_Toc213739263) [1.5 Applicability Statement [23](#_Toc213739264)](#_Toc213739264) [1.5.1 Toolbar Customization [23](#_Toc213739265)](#_Toc213739265) [1.5.2 Property Set Storage [23](#_Toc213739266)](#_Toc213739266) [1.5.3 Visual Basic for Applications Digital Signature [23](#_Toc213739267)](#_Toc213739267) [1.6 Versioning and Localization [23](#versioning-and-localization)](#versioning-and-localization) [1.6.1 Toolbar Customization [23](#_Toc213739269)](#_Toc213739269) [1.6.2 Property Set Storage [24](#structure-versions-there-is-only-one-version-of-the-toolbar-customization-structures-section-2.3.1.localization-the-toolbar-customization-structures-define-no-locale-specific-processes-or-data.property-set-storage)](#structure-versions-there-is-only-one-version-of-the-toolbar-customization-structures-section-2.3.1.localization-the-toolbar-customization-structures-define-no-locale-specific-processes-or-data.property-set-storage) [1.6.3 Visual Basic for Applications Digital Signature [24](#structure-versions-there-is-only-one-version-of-the-property-sets-defined-in-property-set-storage-section-2.3.3.localization-the-encoding-of-strings-contained-in-the-lpstr-section-2.3.3.1.4-data-type-and-the-unalignedlpstr-section-2.3.3.1.5-data-type-depend-on-the-property-sets-codepage-property-described-in-ms-oleps-section-2.18.2.visual-basic-for-applications-digital-signature)](#structure-versions-there-is-only-one-version-of-the-property-sets-defined-in-property-set-storage-section-2.3.3.localization-the-encoding-of-strings-contained-in-the-lpstr-section-2.3.3.1.4-data-type-and-the-unalignedlpstr-section-2.3.3.1.5-data-type-depend-on-the-property-sets-codepage-property-described-in-ms-oleps-section-2.18.2.visual-basic-for-applications-digital-signature) [1.7 Vendor-Extensible Fields [24](#structure-versions-there-is-only-one-version-of-the-vba-digital-signature-defined-in-visual-basic-for-applications-digital-signature-storage-section-2.3.2.localization-the-vba-digital-signature-structures-define-no-locale-specific-processes-or-data.vendor-extensible-fields)](#structure-versions-there-is-only-one-version-of-the-vba-digital-signature-defined-in-visual-basic-for-applications-digital-signature-storage-section-2.3.2.localization-the-vba-digital-signature-structures-define-no-locale-specific-processes-or-data.vendor-extensible-fields) [1.7.1 Toolbar Customization [24](#_Toc213739273)](#_Toc213739273) [1.7.2 Property Set Storage [24](#_Toc213739274)](#_Toc213739274) [1.7.3 Visual Basic for Applications Digital Signature [24](#_Toc213739275)](#_Toc213739275) [2 Structures [25](#structures)](#structures) [2.1 Common ABNF Definitions [25](#_Toc213739277)](#_Toc213739277) [2.2 Data Types [27](#data-types)](#data-types) [2.2.1 Common Data Types [27](#common-data-types)](#common-data-types) [2.2.1.1 ObjectUpdateEnum [27](#_Toc213739280)](#_Toc213739280) [2.2.1.2 DataViewAspectEnum [27](#_Toc213739281)](#_Toc213739281) [2.2.1.3 MSONFC [27](#_Toc213739282)](#_Toc213739282) [2.2.1.4 WebScreenSizeEnum [29](#_Toc213739283)](#_Toc213739283) [2.2.1.5 FilePointer [30](#_Toc213739284)](#_Toc213739284) [2.2.1.6 FixedPoint [30](#_Toc213739285)](#_Toc213739285) [2.3 Common Objects [30](#common-objects)](#common-objects) [2.3.1 Toolbar Customization [30](#_Toc213739287)](#_Toc213739287) [2.3.1.1 TBCBitmap [30](#_Toc213739288)](#_Toc213739288) [2.3.1.2 BITMAPINFOHEADER [31](#_Toc213739289)](#_Toc213739289) [2.3.1.3 RGBQuad [32](#_Toc213739290)](#_Toc213739290) [2.3.1.4 WString [33](#_Toc213739291)](#_Toc213739291) [2.3.1.5 SRECT [33](#_Toc213739292)](#_Toc213739292) [2.3.1.6 TB [34](#_Toc213739293)](#_Toc213739293) [2.3.1.7 TBTRFlags [34](#_Toc213739294)](#_Toc213739294) [2.3.1.8 TBFlags [36](#_Toc213739295)](#_Toc213739295) [2.3.1.9 TBVisualData [36](#_Toc213739296)](#_Toc213739296) [2.3.1.10 TBCHeader [39](#_Toc213739297)](#_Toc213739297) [2.3.1.11 TBCFlags [40](#_Toc213739298)](#_Toc213739298) [2.3.1.12 TBCSFlags [40](#_Toc213739299)](#_Toc213739299) [2.3.1.13 TBCData [43](#_Toc213739300)](#_Toc213739300) [2.3.1.14 TBCGeneralInfo [44](#_Toc213739301)](#_Toc213739301) [2.3.1.15 TBCGIFlags [44](#_Toc213739302)](#_Toc213739302) [2.3.1.16 TBCExtraInfo [45](#_Toc213739303)](#_Toc213739303) [2.3.1.17 TBCBSpecific [46](#_Toc213739304)](#_Toc213739304) [2.3.1.18 TBCBSFlags [47](#_Toc213739305)](#_Toc213739305) [2.3.1.19 TBCComboDropdownSpecific [48](#_Toc213739306)](#_Toc213739306) [2.3.1.20 TBCCDData [49](#_Toc213739307)](#_Toc213739307) [2.3.1.21 TBCMenuSpecific [49](#_Toc213739308)](#_Toc213739308) [2.3.2 Visual Basic for Applications Digital Signature Storage [50](#_Toc213739309)](#_Toc213739309) [2.3.2.1 DigSigInfoSerialized [50](#_Toc213739310)](#_Toc213739310) [2.3.2.2 DigSigBlob [52](#_Toc213739311)](#_Toc213739311) [2.3.2.3 WordSigBlob [52](#_Toc213739312)](#_Toc213739312) [2.3.2.4 VBA Digital Signature [53](#_Toc213739313)](#_Toc213739313) [2.3.2.4.1 SignedData Constraints [53](#_Toc213739314)](#_Toc213739314) [2.3.2.4.2 SignerInfo Constraints [53](#the-digestalgorithms-field-must-contain-only-one-digestalgorithmidentifier-pkcs7-section-6.3-and-that-digestalgorithmidentifier-must-specify-the-identifier-of-the-algorithm-used-to-create-the-digest-of-the-signature.10the-contentinfo-fields-contenttype-must-be-an-object-identifier-itux680-with-the-value-1.3.6.1.4.1.311.2.1.4.-the-content-field-of-the-contentinfo-of-this-signeddata-structure-must-be-a-spcindirectdatacontent-structure-section-2.3.2.4.3.1.the-certificates-field-must-contain-certificates-as-specified-by-pkcs7-section-9.1.-this-must-include-the-signature-verification-certificate-and-can-contain-any-intermediate-certificates-between-that-end-entity-and-the-root-including-the-root.-if-the-signeddata-contains-a-countersignature-pkcs9-section-6.6-the-certificates-associated-with-the-countersignature-also-must-be-contained-in-the-certificates-field.the-crls-field-should-be-absent.-if-present-the-crls-field-must-be-ignored.the-signerinfos-field-must-contain-a-single-signerinfo-structure-section-2.3.2.4.2-pkcs7-section-9.2.signerinfo-constraints)](#the-digestalgorithms-field-must-contain-only-one-digestalgorithmidentifier-pkcs7-section-6.3-and-that-digestalgorithmidentifier-must-specify-the-identifier-of-the-algorithm-used-to-create-the-digest-of-the-signature.10the-contentinfo-fields-contenttype-must-be-an-object-identifier-itux680-with-the-value-1.3.6.1.4.1.311.2.1.4.-the-content-field-of-the-contentinfo-of-this-signeddata-structure-must-be-a-spcindirectdatacontent-structure-section-2.3.2.4.3.1.the-certificates-field-must-contain-certificates-as-specified-by-pkcs7-section-9.1.-this-must-include-the-signature-verification-certificate-and-can-contain-any-intermediate-certificates-between-that-end-entity-and-the-root-including-the-root.-if-the-signeddata-contains-a-countersignature-pkcs9-section-6.6-the-certificates-associated-with-the-countersignature-also-must-be-contained-in-the-certificates-field.the-crls-field-should-be-absent.-if-present-the-crls-field-must-be-ignored.the-signerinfos-field-must-contain-a-single-signerinfo-structure-section-2.3.2.4.2-pkcs7-section-9.2.signerinfo-constraints) [2.3.2.4.3 SignedData contentInfo Structures [54](#the-authenticatedattributes-section-2.3.2.4.4-field-must-be-present.this-field-must-contain-the-following-attributesa-content-type-attribute-with-its-value-set-as-specified-in-pkcs7-section-9.2.a-message-digest-attribute-with-its-value-set-as-specified-in-pkcs7-section-9.2.this-field-can-also-containone-spcstatementtype-attribute-section-2.3.2.4.4.1-but-this-attribute-must-be-ignored.one-spcspopusinfo-attribute-section-2.3.2.4.4.2.if-the-signature-has-been-timestamped-then-the-unauthenticatedattributes-field-section-2.3.2.4.5-must-be-present-and-must-contain-a-single-countersignature-attribute-pkcs9-section-6.6.-if-the-signature-has-not-been-timestamped-the-unauthenticatedattributes-field-must-be-absent.signeddata-contentinfo-structures)](#the-authenticatedattributes-section-2.3.2.4.4-field-must-be-present.this-field-must-contain-the-following-attributesa-content-type-attribute-with-its-value-set-as-specified-in-pkcs7-section-9.2.a-message-digest-attribute-with-its-value-set-as-specified-in-pkcs7-section-9.2.this-field-can-also-containone-spcstatementtype-attribute-section-2.3.2.4.4.1-but-this-attribute-must-be-ignored.one-spcspopusinfo-attribute-section-2.3.2.4.4.2.if-the-signature-has-been-timestamped-then-the-unauthenticatedattributes-field-section-2.3.2.4.5-must-be-present-and-must-contain-a-single-countersignature-attribute-pkcs9-section-6.6.-if-the-signature-has-not-been-timestamped-the-unauthenticatedattributes-field-must-be-absent.signeddata-contentinfo-structures) [2.3.2.4.3.1 SpcIndirectDataContent [54](#_Toc213739317)](#_Toc213739317) [2.3.2.4.3.2 SpcIndirectDataContentV2 [55](#the-digestalgorithm-field-must-be-an-algorithmidentifier-structure.-the-algorithm-field-of-digestalgorithm-specifies-the-object-identifier-itux680-of-the-digest-algorithm-that-was-used-to-hash-the-vba-project-contents-producing-the-value-for-the-digest-field.-this-object-identifier-itux680-value-must-be-set-to-the-same-algorithm-identifier-as-specified-in-the-digestalgorithm-field-of-the-signeddata-structure-section-2.3.2.4.1.-the-parameters-field-of-digestalgorithm-must-be-set-to-the-null-type-itux680-with-a-length-of-zero.the-digest-field-must-be-an-octetstring-itux680.-the-value-of-the-octetstring-must-be-produced-by-means-of-the-hash-algorithm-specified-in-ms-ovba-section-2.4.2.spcindirectdatacontentv2)](#the-digestalgorithm-field-must-be-an-algorithmidentifier-structure.-the-algorithm-field-of-digestalgorithm-specifies-the-object-identifier-itux680-of-the-digest-algorithm-that-was-used-to-hash-the-vba-project-contents-producing-the-value-for-the-digest-field.-this-object-identifier-itux680-value-must-be-set-to-the-same-algorithm-identifier-as-specified-in-the-digestalgorithm-field-of-the-signeddata-structure-section-2.3.2.4.1.-the-parameters-field-of-digestalgorithm-must-be-set-to-the-null-type-itux680-with-a-length-of-zero.the-digest-field-must-be-an-octetstring-itux680.-the-value-of-the-octetstring-must-be-produced-by-means-of-the-hash-algorithm-specified-in-ms-ovba-section-2.4.2.spcindirectdatacontentv2) [2.3.2.4.4 SignerInfo authenticatedAttributes Structures [56](#the-algorithmidsize-field-must-be-an-integer-itux680-and-the-value-must-be-equal-to-the-size-of-the-algorithmid-field.the-compiledhashsize-field-should-be-zero.the-sourcehashsize-field-must-be-an-integer-itux680-and-the-value-must-be-equal-to-the-size-of-the-sourcehash-field.the-algorithmidoffset-field-must-be-an-integer-itux680-and-the-value-must-be-equal-to-the-position-in-bytes-of-the-algorithmid-field-from-the-beginning-of-the-structure.the-compiledhashoffset-field-should-be-zero.the-sourcehashoffset-field-must-be-an-integer-itux680-and-the-value-must-be-equal-to-the-position-in-bytes-of-the-sourcehash-field-from-the-beginning-of-the-structure.the-algorithmid-field-specifies-the-object-identifier-itux680-of-the-digest-algorithm-that-was-used-to-hash-the-vba-project-contents-producing-the-value-for-the-digest-field.-this-object-identifier-itux680-value-must-be-set-to-the-same-algorithm-identifier-as-specified-in-the-digestalgorithm-field-of-the-signeddata-structure.the-compiledhash-field-should-be-empty.the-sourcehash-field-must-be-an-octetstring-itux680.-the-value-of-the-octetstring-must-be-produced-by-means-of-the-hash-algorithm-specified-in-ms-ovba-section-2.4.2.signerinfo-authenticatedattributes-structures)](#the-algorithmidsize-field-must-be-an-integer-itux680-and-the-value-must-be-equal-to-the-size-of-the-algorithmid-field.the-compiledhashsize-field-should-be-zero.the-sourcehashsize-field-must-be-an-integer-itux680-and-the-value-must-be-equal-to-the-size-of-the-sourcehash-field.the-algorithmidoffset-field-must-be-an-integer-itux680-and-the-value-must-be-equal-to-the-position-in-bytes-of-the-algorithmid-field-from-the-beginning-of-the-structure.the-compiledhashoffset-field-should-be-zero.the-sourcehashoffset-field-must-be-an-integer-itux680-and-the-value-must-be-equal-to-the-position-in-bytes-of-the-sourcehash-field-from-the-beginning-of-the-structure.the-algorithmid-field-specifies-the-object-identifier-itux680-of-the-digest-algorithm-that-was-used-to-hash-the-vba-project-contents-producing-the-value-for-the-digest-field.-this-object-identifier-itux680-value-must-be-set-to-the-same-algorithm-identifier-as-specified-in-the-digestalgorithm-field-of-the-signeddata-structure.the-compiledhash-field-should-be-empty.the-sourcehash-field-must-be-an-octetstring-itux680.-the-value-of-the-octetstring-must-be-produced-by-means-of-the-hash-algorithm-specified-in-ms-ovba-section-2.4.2.signerinfo-authenticatedattributes-structures) [2.3.2.4.4.1 SpcStatementType [57](#_Toc213739320)](#_Toc213739320) [2.3.2.4.4.2 SpcSpOpusInfo [57](#_Toc213739321)](#_Toc213739321) [2.3.2.4.4.3 SpcString [57](#_Toc213739322)](#_Toc213739322) [2.3.2.4.4.4 SpcLink [57](#_Toc213739323)](#_Toc213739323) [2.3.2.4.5 SignerInfo unauthenticatedAttributes [57](#_Toc213739324)](#_Toc213739324) [2.3.2.4.6 VBA Digital Signature Verification [58](#_Toc213739325)](#_Toc213739325) [2.3.2.4.6.1 Certificate Processing [58](#_Toc213739326)](#_Toc213739326) [2.3.2.4.6.2 Timestamp Processing [58](#_Toc213739327)](#_Toc213739327) [2.3.2.5 Serialized Certificate Store Structure [58](#the-certificate-chain-for-the-countersignature-must-be-built-according-to-a-trusted-root-certificate-by-using-x.509-path-validation-rules-as-specified-by-rfc3280-section-6.the-time-stamp-authority-tsa-certificate-that-was-used-to-sign-the-timestamp-must-contain-the-eku-value-for-timestamping-1.3.6.1.5.5.7.3.8.serialized-certificate-store-structure)](#the-certificate-chain-for-the-countersignature-must-be-built-according-to-a-trusted-root-certificate-by-using-x.509-path-validation-rules-as-specified-by-rfc3280-section-6.the-time-stamp-authority-tsa-certificate-that-was-used-to-sign-the-timestamp-must-contain-the-eku-value-for-timestamping-1.3.6.1.5.5.7.3.8.serialized-certificate-store-structure) [2.3.2.5.1 SerializedCertificateEntry [58](#_Toc213739329)](#_Toc213739329) [2.3.2.5.2 EndElementMarkerEntry [59](#_Toc213739330)](#_Toc213739330) [2.3.2.5.3 SerializedPropertyEntry [59](#_Toc213739331)](#_Toc213739331) [2.3.2.5.4 CertStoreCertificateGroup [60](#_Toc213739332)](#_Toc213739332) [2.3.2.5.5 VBASigSerializedCertStore [60](#_Toc213739333)](#_Toc213739333) [2.3.3 Property Set Storage [61](#_Toc213739334)](#_Toc213739334) [2.3.3.1 Property Types [61](#_Toc213739335)](#_Toc213739335) [2.3.3.1.1 PropertySetSystemIdentifier [61](#_Toc213739336)](#_Toc213739336) [2.3.3.1.2 VtThumbnailValue [62](#_Toc213739337)](#_Toc213739337) [2.3.3.1.3 VtThumbnail [63](#_Toc213739338)](#_Toc213739338) [2.3.3.1.4 Lpstr [63](#_Toc213739339)](#_Toc213739339) [2.3.3.1.5 UnalignedLpstr [64](#_Toc213739340)](#_Toc213739340) [2.3.3.1.6 Lpwstr [64](#_Toc213739341)](#_Toc213739341) [2.3.3.1.7 VtVecLpwstrValue [65](#_Toc213739342)](#_Toc213739342) [2.3.3.1.8 VtVecLpwstr [65](#_Toc213739343)](#_Toc213739343) [2.3.3.1.9 VtVecUnalignedLpstrValue [65](#_Toc213739344)](#_Toc213739344) [2.3.3.1.10 VtVecUnalignedLpstr [66](#_Toc213739345)](#_Toc213739345) [2.3.3.1.11 VtString [66](#_Toc213739346)](#_Toc213739346) [2.3.3.1.12 VtUnalignedString [67](#_Toc213739347)](#_Toc213739347) [2.3.3.1.13 VtHeadingPair [67](#_Toc213739348)](#_Toc213739348) [2.3.3.1.14 VtVecHeadingPairValue [68](#_Toc213739349)](#_Toc213739349) [2.3.3.1.15 VtVecHeadingPair [68](#_Toc213739350)](#_Toc213739350) [2.3.3.1.16 VtDigSigValue [69](#_Toc213739351)](#_Toc213739351) [2.3.3.1.17 VtDigSig [69](#_Toc213739352)](#_Toc213739352) [2.3.3.1.18 VtHyperlink [69](#_Toc213739353)](#_Toc213739353) [2.3.3.1.19 VecVtHyperlink [71](#_Toc213739354)](#_Toc213739354) [2.3.3.1.20 VtHyperlinkValue [71](#_Toc213739355)](#_Toc213739355) [2.3.3.1.21 VtHyperlinks [71](#_Toc213739356)](#_Toc213739356) [2.3.3.2 OLE Property Sets [72](#_Toc213739357)](#_Toc213739357) [2.3.3.2.1 Summary Information Property Set [72](#_Toc213739358)](#_Toc213739358) [2.3.3.2.1.1 PIDSI [72](#_Toc213739359)](#_Toc213739359) [2.3.3.2.2 Document Summary Information Property Set [74](#_Toc213739360)](#_Toc213739360) [2.3.3.2.2.1 PIDDSI [75](#_Toc213739361)](#_Toc213739361) [2.3.3.2.3 User Defined Property Set [78](#_Toc213739362)](#_Toc213739362) [2.3.3.2.3.1 User Defined Property Set Constraints [79](#_Toc213739363)](#_Toc213739363) [2.3.3.2.3.1.1 Required Properties [79](#_Toc213739364)](#_Toc213739364) [2.3.3.2.3.1.2 Supported Types [79](#_Toc213739365)](#_Toc213739365) [2.3.3.2.3.2 Reserved Properties [79](#vtstring-section-2.3.3.1.11typedpropertyvalue-ms-oleps-section-2.15-the-type-of-which-must-be-one-of-the-following-typesvt_i4-0x0003vt_r8-0x0005vt_bool-0x000bvt_filetime-0x0040vt_blob-0x0041reserved-properties)](#vtstring-section-2.3.3.1.11typedpropertyvalue-ms-oleps-section-2.15-the-type-of-which-must-be-one-of-the-following-typesvt_i4-0x0003vt_r8-0x0005vt_bool-0x000bvt_filetime-0x0040vt_blob-0x0041reserved-properties) [2.3.3.2.3.3 Linked Properties [85](#_Toc213739367)](#_Toc213739367) [2.3.4 SmartTag Objects [85](#_Toc213739368)](#_Toc213739368) [2.3.4.1 PropertyBagStore [85](#_Toc213739369)](#_Toc213739369) [2.3.4.2 FactoidType [86](#_Toc213739370)](#_Toc213739370) [2.3.4.3 PropertyBag [87](#_Toc213739371)](#_Toc213739371) [2.3.4.4 Property [87](#_Toc213739372)](#_Toc213739372) [2.3.4.5 PBString [88](#_Toc213739373)](#_Toc213739373) [2.3.5 RefEdit Control [88](#_Toc213739374)](#_Toc213739374) [2.3.6 Custom XML Data Storage [88](#_Toc213739375)](#_Toc213739375) [2.3.6.1 Custom XML Data Storage Item [88](#_Toc213739376)](#_Toc213739376) [2.3.6.1.1 Custom Property Editor [89](#_Toc213739377)](#_Toc213739377) [2.3.6.1.1.1 XMLNamespace [89](#_Toc213739378)](#_Toc213739378) [2.3.6.1.1.2 XSNLocation [89](#_Toc213739379)](#_Toc213739379) [2.3.6.1.1.3 showOnOpen [89](#_Toc213739380)](#_Toc213739380) [2.3.6.1.1.4 defaultPropertyEditorNamespace [90](#_Toc213739381)](#_Toc213739381) [2.3.6.1.1.5 customPropertyEditor [90](#_Toc213739382)](#_Toc213739382) [2.3.6.1.1.6 customPropertyEditors [90](#_Toc213739383)](#_Toc213739383) [2.3.6.1.2 Custom Xsn [91](#_Toc213739384)](#_Toc213739384) [2.3.6.1.2.1 ST_TrueFalse [91](#_Toc213739385)](#_Toc213739385) [2.3.6.1.2.2 xsnLocation [91](#_Toc213739386)](#_Toc213739386) [2.3.6.1.2.3 cached [91](#_Toc213739387)](#_Toc213739387) [2.3.6.1.2.4 openByDefault [91](#_Toc213739388)](#_Toc213739388) [2.3.6.1.2.5 xsnScope [92](#_Toc213739389)](#_Toc213739389) [2.3.6.1.2.6 customXsn [92](#_Toc213739390)](#_Toc213739390) [2.3.6.1.3 Schema for Content Type [92](#_Toc213739391)](#_Toc213739391) [2.3.6.1.3.1 ContentTypeId [92](#_Toc213739392)](#_Toc213739392) [2.3.6.1.3.2 IntNonNegative [93](#_Toc213739393)](#_Toc213739393) [2.3.6.1.3.3 UniqueIdentifierWithoutBraces [93](#_Toc213739394)](#_Toc213739394) [2.3.6.1.3.4 UniqueIdentifierWithoutBracesOrEmpty [93](#_Toc213739395)](#_Toc213739395) [2.3.6.1.3.5 DummyContentTypeElement [93](#_Toc213739396)](#_Toc213739396) [2.3.6.1.3.6 schema [98](#_Toc213739397)](#_Toc213739397) [2.3.6.1.3.7 contentTypeSchema [98](#_Toc213739398)](#_Toc213739398) [2.3.6.1.4 Cover Page Properties [101](#_Toc213739399)](#_Toc213739399) [2.3.6.1.4.1 ST_PublishDate [101](#_Toc213739400)](#_Toc213739400) [2.3.6.1.4.2 PublishDate [101](#_Toc213739401)](#_Toc213739401) [2.3.6.1.4.3 Abstract [101](#_Toc213739402)](#_Toc213739402) [2.3.6.1.4.4 CompanyAddress [101](#_Toc213739403)](#_Toc213739403) [2.3.6.1.4.5 CompanyPhone [101](#_Toc213739404)](#_Toc213739404) [2.3.6.1.4.6 CompanyFax [101](#_Toc213739405)](#_Toc213739405) [2.3.6.1.4.7 CompanyEmail [101](#_Toc213739406)](#_Toc213739406) [2.3.6.1.4.8 CoverPageProperties [102](#_Toc213739407)](#_Toc213739407) [2.3.6.1.5 Long Properties [102](#_Toc213739408)](#_Toc213739408) [2.3.6.1.5.1 LongProp [102](#_Toc213739409)](#_Toc213739409) [2.3.6.1.5.2 LongProperties [102](#_Toc213739410)](#_Toc213739410) [2.3.6.2 Custom XML Data Storage Properties [103](#_Toc213739411)](#_Toc213739411) [2.3.6.2.1 ST_Guid [103](#_Toc213739412)](#_Toc213739412) [2.3.6.2.2 schemaRef [103](#_Toc213739413)](#_Toc213739413) [2.3.6.2.3 schemaRefs [103](#_Toc213739414)](#_Toc213739414) [2.3.6.2.4 dataStoreItem [104](#_Toc213739415)](#_Toc213739415) [2.3.7 Hyperlinks [104](#_Toc213739416)](#_Toc213739416) [2.3.7.1 Hyperlink Object [104](#_Toc213739417)](#_Toc213739417) [2.3.7.2 HyperlinkMoniker [106](#_Toc213739418)](#_Toc213739418) [2.3.7.3 CompositeMoniker [107](#_Toc213739419)](#_Toc213739419) [2.3.7.4 AntiMoniker [107](#_Toc213739420)](#_Toc213739420) [2.3.7.5 ItemMoniker [107](#_Toc213739421)](#_Toc213739421) [2.3.7.6 URLMoniker [109](#_Toc213739422)](#_Toc213739422) [2.3.7.7 URICreateFlags [109](#_Toc213739423)](#_Toc213739423) [2.3.7.8 FileMoniker [111](#_Toc213739424)](#_Toc213739424) [2.3.7.9 HyperlinkString [112](#_Toc213739425)](#_Toc213739425) [2.3.8 MsoEnvelope [113](#_Toc213739426)](#_Toc213739426) [2.3.8.1 MsoEnvelopeCLSID [113](#_Toc213739427)](#_Toc213739427) [2.3.8.2 MsoEnvelope [113](#_Toc213739428)](#_Toc213739428) [2.3.8.3 EnvRecipientCollection [117](#_Toc213739429)](#_Toc213739429) [2.3.8.4 EnvRecipientProperties [117](#_Toc213739430)](#_Toc213739430) [2.3.8.5 EnvRecipientProperty [118](#_Toc213739431)](#_Toc213739431) [2.3.8.6 EnvRecipientPropertyBlob [118](#_Toc213739432)](#_Toc213739432) [2.3.8.7 PT_LONG [119](#_Toc213739433)](#_Toc213739433) [2.3.8.8 PT_NULL [119](#_Toc213739434)](#_Toc213739434) [2.3.8.9 PT_BOOLEAN [119](#_Toc213739435)](#_Toc213739435) [2.3.8.10 PT_SYSTIME [120](#_Toc213739436)](#_Toc213739436) [2.3.8.11 PT_ERROR [120](#_Toc213739437)](#_Toc213739437) [2.3.8.12 PT_STRING8 [120](#_Toc213739438)](#_Toc213739438) [2.3.8.13 PT_UNICODE [120](#_Toc213739439)](#_Toc213739439) [2.3.8.14 PT_BINARY [121](#_Toc213739440)](#_Toc213739440) [2.3.8.15 PT_MV_STRING8 [121](#_Toc213739441)](#_Toc213739441) [2.3.8.16 PT_MV_BINARY [122](#_Toc213739442)](#_Toc213739442) [2.3.8.17 EnvAttachmentCollection [122](#_Toc213739443)](#_Toc213739443) [2.3.8.18 EnvAttachment [122](#_Toc213739444)](#_Toc213739444) [2.3.8.19 IntroText [123](#_Toc213739445)](#_Toc213739445) [2.3.9 Document Signature Serialized Certificate Store Structure [124](#_Toc213739446)](#_Toc213739446) [2.3.9.1 DocSigSerializedCertStore [124](#_Toc213739447)](#_Toc213739447) [2.4 Common Algorithms [124](#common-algorithms)](#common-algorithms) [2.4.1 Unicode String to Unsigned Integer Hash [124](#_Toc213739449)](#_Toc213739449) [2.4.2 Hyperlink Hash [125](#the-result-of-the-algorithm-is-the-value-dwhash.hyperlink-hash)](#the-result-of-the-algorithm-is-the-value-dwhash.hyperlink-hash) [2.4.3 MsoCrc32Compute [125](#_Toc213739451)](#_Toc213739451) [2.4.3.1 Caching Algorithm [125](#_Toc213739452)](#_Toc213739452) [2.4.3.2 CRC Computation [126](#_Toc213739453)](#_Toc213739453) [2.4.4 Date/Time Format from Format Index [126](#_Toc213739454)](#_Toc213739454) [2.4.4.1 Format Indices [126](#_Toc213739455)](#_Toc213739455) [2.4.4.2 Base Format Strings [127](#_Toc213739456)](#_Toc213739456) [2.4.4.3 Retrieve Format [127](#_Toc213739457)](#_Toc213739457) [2.4.4.3.1 Chinese Formats [127](#_Toc213739458)](#_Toc213739458) [2.4.4.3.2 Hindi Formats [128](#_Toc213739459)](#_Toc213739459) [2.4.4.3.3 Japanese Formats [128](#_Toc213739460)](#_Toc213739460) [2.4.4.3.4 Korean Formats [129](#_Toc213739461)](#_Toc213739461) [2.4.4.3.5 Taiwanese Formats [129](#_Toc213739462)](#_Toc213739462) [2.4.4.3.6 Thai Formats [130](#_Toc213739463)](#_Toc213739463) [2.4.4.3.7 Yi Formats [130](#_Toc213739464)](#_Toc213739464) [2.4.4.3.8 Formats for all other Locales [131](#_Toc213739465)](#_Toc213739465) [2.4.4.4 Apply Format Exceptions [132](#_Toc213739466)](#_Toc213739466) [2.4.4.4.1 Bokmål (Norwegian) [132](#_Toc213739467)](#_Toc213739467) [2.4.4.4.2 Czech [132](#_Toc213739468)](#_Toc213739468) [2.4.4.4.3 Danish [132](#_Toc213739469)](#_Toc213739469) [2.4.4.4.4 Dutch [133](#_Toc213739470)](#_Toc213739470) [2.4.4.4.5 Finnish [133](#_Toc213739471)](#_Toc213739471) [2.4.4.4.6 French Canadian [133](#_Toc213739472)](#_Toc213739472) [2.4.4.4.7 German [133](#_Toc213739473)](#_Toc213739473) [2.4.4.4.8 Hungarian [133](#_Toc213739474)](#_Toc213739474) [2.4.4.4.9 Italian [133](#_Toc213739475)](#_Toc213739475) [2.4.4.4.10 Japanese [133](#_Toc213739476)](#_Toc213739476) [2.4.4.4.11 Kazakh [133](#_Toc213739477)](#_Toc213739477) [2.4.4.4.12 Khmer [134](#_Toc213739478)](#_Toc213739478) [2.4.4.4.13 Korean [134](#_Toc213739479)](#_Toc213739479) [2.4.4.4.14 Lao [134](#_Toc213739480)](#_Toc213739480) [2.4.4.4.15 Lithuanian [134](#_Toc213739481)](#_Toc213739481) [2.4.4.4.16 Polish [134](#_Toc213739482)](#_Toc213739482) [2.4.4.4.17 Portuguese [134](#_Toc213739483)](#_Toc213739483) [2.4.4.4.18 Russian [134](#_Toc213739484)](#_Toc213739484) [2.4.4.4.19 Spanish [134](#_Toc213739485)](#_Toc213739485) [2.4.4.4.20 Swedish [134](#_Toc213739486)](#_Toc213739486) [2.4.4.4.21 Tibetan [135](#_Toc213739487)](#_Toc213739487) [2.4.4.4.22 Uzbek Cyrillic [135](#_Toc213739488)](#_Toc213739488) [2.4.4.4.23 Vietnamese [135](#_Toc213739489)](#_Toc213739489) [2.4.4.4.24 Bhutanese [135](#_Toc213739490)](#_Toc213739490) [3 Structure Examples [136](#structure-examples)](#structure-examples) [3.1 Toolbar Customization Examples [136](#_Toc213739492)](#_Toc213739492) [3.1.1 Toolbar Control Example [136](#_Toc213739493)](#_Toc213739493) [3.1.2 Toolbar Delta Example [141](#_Toc213739494)](#_Toc213739494) [3.2 Document Summary Information Examples [143](#_Toc213739495)](#_Toc213739495) [3.2.1 Document Summary Information Stream Overview [145](#_Toc213739496)](#_Toc213739496) [3.2.2 Document Summary Information Property Set Overview [147](#_Toc213739497)](#_Toc213739497) [3.2.2.1 CodePage Property Example [150](#_Toc213739498)](#_Toc213739498) [3.2.2.2 Category Property Example [151](#_Toc213739499)](#_Toc213739499) [3.2.2.3 LineCount Property Example [151](#_Toc213739500)](#_Toc213739500) [3.2.2.4 LinksDirty Property Example [152](#_Toc213739501)](#_Toc213739501) [3.2.2.5 DocumentParts Property Example [152](#_Toc213739502)](#_Toc213739502) [3.2.2.6 HeadingPairs Property Example [155](#_Toc213739503)](#_Toc213739503) [3.2.3 User Defined Property Set Overview [157](#_Toc213739504)](#_Toc213739504) [3.2.3.1 Dictionary Property Example [160](#dictionary-property-example)](#dictionary-property-example) [3.2.3.2 LinkBase Property Example [163](#linkbase-property-example)](#linkbase-property-example) [3.2.3.3 Hyperlinks Property Example [163](#_Toc213739507)](#_Toc213739507) [3.2.3.3.1 LinkElement-1 Example [164](#_Toc213739508)](#_Toc213739508) [3.2.3.3.2 LinkElement-2 Example [166](#_Toc213739509)](#_Toc213739509) [3.2.3.3.3 LinkElement-3 Example [168](#_Toc213739510)](#_Toc213739510) [3.2.3.3.4 LinkElement-4 Example [169](#_Toc213739511)](#_Toc213739511) [3.2.3.3.5 LinkElement-5 Example [171](#_Toc213739512)](#_Toc213739512) [3.2.3.3.6 LinkElement-6 Example [173](#_Toc213739513)](#_Toc213739513) [3.2.3.4 Linked Property Example [174](#linked-property-example)](#linked-property-example) [3.3 SmartTag Examples [175](#_Toc213739515)](#_Toc213739515) [3.4 Visual Basic for Applications Digital Signature Example Structures [181](#_Toc213739516)](#_Toc213739516) [4 Security Considerations [185](#security-considerations)](#security-considerations) [4.1 Toolbar Customization [185](#_Toc213739518)](#_Toc213739518) [4.2 Property Set Storage [185](#_Toc213739519)](#_Toc213739519) [4.3 Visual Basic for Applications Digital Signature [185](#_Toc213739520)](#_Toc213739520) [5 Appendix A: Product Behavior [186](#_Toc213739521)](#_Toc213739521) [6 Change Tracking [195](#_Toc213739522)](#_Toc213739522) [7 Index [196](#index)](#index) # Introduction The Office Common Data Types and Objects Structures provide a collection of common data types, objects, and algorithms used by various Office application binary file formats. While the structure of the persistence of the data types and objects is specified in this document, their location in the binary formats is determined by the host application. 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: > **absolute path**: A string that identifies the location of a file and that begins with a drive identifier and root directory or network share and ends with the complete file name. Examples are C:\Documents\Work\example.txt and \\netshare\Documents\Work\example.txt. > > **accelerator key**: Any combination of keys that are pressed simultaneously to run a command. > > **ActiveX control**: A reusable software control, such as a check box or button, that uses ActiveX technology and provides options to users or runs macros or scripts that automate a task. See also ActiveX object. > > **adaptive menu**: A type of menu that displays the most recently used commands at the top of that menu. > > **add-in**: Supplemental functionality that is provided by an external application or macro to extend the capabilities of an application. > > **American National Standards Institute (ANSI) character set**: A character set defined by a [**code page**](#gt_210637d9-9634-4652-a935-ded3cd434f38) approved by the American National Standards Institute (ANSI). The term "ANSI" as used to signify Windows code pages is a historical reference and a misnomer that persists in the Windows community. The source of this misnomer stems from the fact that the Windows code page 1252 was originally based on an ANSI draft, which became International Organization for Standardization (ISO) Standard 8859-1 [\[ISO/IEC-8859-1\]](https://go.microsoft.com/fwlink/?LinkId=90689). In Windows, the ANSI character set can be any of the following code pages: 1252, 1250, 1251, 1253, 1254, 1255, 1256, 1257, 1258, 874, 932, 936, 949, or 950. For example, "ANSI application" is usually a reference to a non-[**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) or code-page-based application. Therefore, "ANSI character set" is often misused to refer to one of the character sets defined by a Windows code page that can be used as an active system code page; for example, character sets defined by code page 1252 or character sets defined by code page 950. Windows is now based on Unicode, so the use of ANSI character sets is strongly discouraged unless they are used to interoperate with legacy applications or legacy data. > > **anti-moniker**: A Component Object Model (COM) object that is the inverse of a simple [**moniker**](#gt_b88df1f8-e55a-4d08-9861-e7d6a4ed9abc) and has no internal structure; it is the inverse of a COM implementation of a file, an item, or a pointer moniker. An anti-moniker that is composed to the right of a file moniker, item moniker, or pointer moniker composes to nothing. > > **assembly**: A collection of one or more files that is versioned and deployed as a unit. An assembly is the primary building block of a .NET Framework application. All managed types and resources are contained within an assembly and are marked either as accessible only within the assembly or as accessible from code in other assemblies. Assemblies also play a key role in security. The code access security system uses information about an assembly to determine the set of permissions that is granted to code in the assembly. > > **base URL**: A URL that is specified for a web resource to convert all relative URLs in that resource to absolute URLs. A base URL ends with either a file name, such as http://www.example.com/sample.htm, or a slash, such as http://www.example.com/subdir/. See also absolute URL. > > **basic toolbar**: A toolbar that consists of a row, column, or block of buttons, each of which perform an action when activated. Unlike a [**menu toolbar**](#gt_2eb45441-112f-420b-ab4a-768b569582dc), which displays only text labels, a basic toolbar can display both text and icons. > > **big-endian**: Multiple-byte values that are byte-ordered with the most significant byte stored in the memory location with the lowest address. > > **ButtonPopup control**: A type of Button control that displays a menu of related commands when activated. > > **cell**: A box that is formed by the intersection of a row and a column in a worksheet or a table. A cell can contain numbers, strings, and formulas, and various formats can be applied to that data. > > **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. > > **clipboard format**: An unsigned integer that uniquely identifies the format of a data packet that is stored in a binary large object (BLOB) and can be shared between processes through the operating system clipboard or other means. > > **code page**: An ordered set of characters of a specific script in which a numerical index (code-point value) is associated with each character. Code pages are a means of providing support for character sets and keyboard layouts used in different countries/regions. Devices such as the display and keyboard can be configured to use a specific code page and to switch from one code page (such as the United States) to another (such as Portugal) at the user's request. > > **Component Object Model (COM)**: An object-oriented programming model that defines how objects interact within a single process or between processes. In [**COM**](#gt_ef2ebebc-1760-407a-9ace-af48f9050e02), clients have access to an object through interfaces implemented on the object. For more information, see [\[MS-DCOM\]](%5bMS-DCOM%5d.pdf#Section_4a893f3dbd2948cd9f43d9777a4415b0). > > **composite moniker**: A Component Object Model (COM) object that joins two or more moniker objects and that can determine the relation between the parts. There are two types of composite monikers: generic, which can connect any two monikers regardless of class; and, nongeneric, which can connect monikers only of the same class. > > **context menu**: A menu that is related to the active window, selection, or object. Also referred to as shortcut menu. > > **Coordinated Universal Time (UTC)**: A high-precision atomic time standard that approximately tracks Universal Time (UT). It is the basis for legal, civil time all over the Earth. Time zones around the world are expressed as positive and negative offsets from UTC. In this role, it is also referred to as Zulu time (Z) and Greenwich Mean Time (GMT). In these specifications, all references to UTC refer to the time at UTC-0 (or GMT). > > **custom toolbar**: A type of toolbar that contains a user-defined set of controls and is not included in an application by default. A custom toolbar has a toolbar identifier value of "1". > > **custom toolbar control**: A user-defined control that can be added to a toolbar. A custom toolbar control has a [**toolbar control identifier (TCID)**](#gt_28d9adbd-b340-469a-97cd-3befd6a782b3) value of "1" and can be one of the following types of controls: ActiveX, Button, ComboBox, DropDown, Edit, or Popup. > > **cyclic redundancy check (CRC)**: An algorithm used to produce a checksum (a small, fixed number of bits) against a block of data, such as a packet of network traffic or a block of a computer file. The CRC is a broad class of functions used to detect errors after transmission or storage. A CRC is designed to catch random errors, as opposed to intentional errors. If errors might be introduced by a motivated and intelligent adversary, a cryptographic hash function has to be used instead. > > **datasheet**: A worksheet window that contains the source data for a Microsoft Graph chart object. > > **digital certificate**: See the "digital certificate definition standard," as described in [\[X509\]](https://go.microsoft.com/fwlink/?LinkId=90590). > > **digital certificate store**: A database that stores a variety of [**digital certificates**](#gt_a1dfa70d-7803-413d-8697-c40021a3f3d0) and information about those certificates, including attributes and constraints. > > **digital signature**: A value that is generated by using a digital signature algorithm, taking as input a private key and an arbitrary-length string, such that a specific verification algorithm is satisfied by the value, the input string, and the public key corresponding to the input private key. > > **docked**: A condition where a toolbar is attached to the [**docking area**](#gt_25929137-cc77-41d9-af22-d3f449b23dcf) of an application window. > > **docked location**: A specific position of a toolbar within the [**docking area**](#gt_25929137-cc77-41d9-af22-d3f449b23dcf) of an application window. > > **docking area**: An area that is adjacent to the edge of an application window. A toolbar can be moved and attached to a docking area. > > **document workspace**: A document repository that enables users to collaborate on one or more documents. > > **ExpandingGrid control**: A type of [**ButtonPopup control**](#gt_d638405a-d78b-4c5f-aed2-8616d98d3519) that displays and sets a value from a continuous range of possible values when the user drags across the menu area. > > **file moniker**: A Component Object Model (COM) object that stores the path name that is assigned to a file by the native file system. > > **Gauge control**: A type of control that displays and sets a value from a continuous range of possible values that the user selects by dragging a slider. An example is the Zoom control in an application window. > > **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) have to be used for generating the GUID. See also universally unique identifier (UUID). > > **GraphicCombo control**: A type of ComboBox control that can display both text and graphics as a list of options. > > **GraphicDropDown control**: A type of DropDown control that can display custom graphics in a list of options. > > **Grid control**: A type of menu control that can be activated by clicking a cell in a grid. An example is the Font Color control. > > **GUID_NULL**: A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) that has the value "{00000000-0000-0000-0000-000000000000}". > > **hash**: A fixed-size result that is obtained by applying a one-way mathematical function, which is sometimes referred to as a hash algorithm, to an arbitrary amount of data. If the input data changes, the hash also changes. The hash can be used in many operations, including authentication and digital signing. > > **hyperlink**: A relationship between two anchors, as described in [\[RFC1866\]](https://go.microsoft.com/fwlink/?LinkId=90296). > > **hyperlink location**: A portion of a hyperlink that specifies the location of a specific item, such as a bookmark, within a document, object, or other type of resource; for example "#bookmark" in the hyperlink location C:\Documents\Document.docx#bookmark. > > **hyperlink target**: A portion of a hyperlink that specifies the document, object, or other resource; for example "C:\Documents\Document.docx" in the hyperlink location C:\Documents\Document.docx#bookmark. > > **item moniker**: A Component Object Model (COM) object that identifies an object that is contained in another object, such as an OLE object that is embedded in a document. > > **Joint Photographic Experts Group (JPEG)**: A raster graphics file format for displaying high-resolution color graphics. JPEG graphics apply a user-specified compression scheme that can significantly reduce the file sizes of photo-realistic color graphics. A higher level of compression results in lower quality, whereas a lower level of compression results in higher quality. JPEG-format files have a .jpg or .jpeg file name extension. > > **language code identifier (LCID)**: A 32-bit number that identifies the user interface human language dialect or variation that is supported by an application or a client computer. > > **linked object**: An object that is inserted into a document and continues to exist in a separate source file. If the object in the source file changes, the object in the document is updated automatically to reflect those changes. > > **little-endian**: Multiple-byte values that are byte-ordered with the least significant byte stored in the memory location with the lowest address. > > **locale**: A collection of rules and data that are specific to a language and a geographical area. A locale can include information about sorting rules, date and time formatting, numeric and monetary conventions, and character classification. > > **locale settings**: A collection of rules and data that are specific to a language and a geographic area. Locale settings include information about sorting rules, date and time formatting, numeric and monetary conventions, and character classification. > > **major version**: An iteration of a software component, document, or list item that is ready for a larger group to see, or has changed significantly from the previous major version. For an item on a SharePoint site, the [**minor version**](#gt_e0d99b53-9426-4a45-8429-b012184a4045) is always "0" (zero) for a major version. > > **managed code**: Code that is executed by the common language runtime (CLR) environment rather than directly by the operating system. Managed code applications gain CLR services, such as automatic garbage collection, runtime type checking, and security support. These services provide uniform behavior that is independent of platform and language. > > **manifest**: A file that stores metadata about an expansion pack, such as the name of the expansion pack, the files and resources that are included in the expansion pack, and the dependencies that it has on other files and components. > > **menu toolbar**: A type of toolbar that is displayed in an application window, typically at the top, and provides a set of menu controls from which the user can select. Activating a control on the toolbar displays a list of commands in that menu, and the menu remains open until the user closes it or chooses a menu command. > > **minor version**: An iteration of a software component, document, or list item that is in progress or has changed only slightly from the previous version. For an item on a SharePoint site, the minor version number is never "0" (zero) and is incremented for each new version of an item, unless a [**major version**](#gt_66583c77-eb07-43c4-8f1b-dd157580db46) is explicitly published. When minor versioning is disabled on a SharePoint site, only major version numbers are incremented, and the minor version is always "0" (zero). > > **moniker**: An object that stores information that uniquely identifies a Component Object Model (COM) object and allows that object to be located and activated. > > **MS-DOS path compatibility mode**: A mode that converts an MS-DOS path into a corresponding path by mapping MS-DOS device names to MS-DOS devices and drive letters. > > **object**: In [**COM**](#gt_ef2ebebc-1760-407a-9ace-af48f9050e02), a software entity that implements the IUnknown interface and zero or more additional interfaces that can be obtained from each other using the IUnknown interface. A [**COM**](#gt_ef2ebebc-1760-407a-9ace-af48f9050e02) [**object**](#gt_8bb43a65-7a8c-4585-a7ed-23044772f8ca) can be exposed to remote clients via the DCOM protocol, in which case it is also a DCOM object. > > **Object Linking and Embedding (OLE)**: A technology for transferring and sharing information between applications by inserting a file or part of a file into a compound document. The inserted file can be either embedded or linked. See also embedded object and [**linked object**](#gt_cfc45e76-9219-4c47-9ef2-5832a172f795). > > **OCXDropDown control**: A type of DropDown control that displays a list of the ActiveX controls that are available within that application. > > **Pane control**: A type of toolbar control that hosts a window within itself. The hosted window is not constrained by the layout and control type options of a [**basic toolbar**](#gt_39d82905-44bc-438d-9b2d-a2cd633a9dd9) or a [**menu toolbar**](#gt_2eb45441-112f-420b-ab4a-768b569582dc). > > **parent directory indicator**: In a hierarchical filing system, two periods followed by a backslash (..\\ that specify a working directory, relative to the current working directory. > > **Popup control**: A built-in or custom control on a menu bar or toolbar that displays a menu of related commands when clicked. > > **range**: An addressable region that is in a workbook. A range typically consists of zero or more cells and represents a single, contiguous rectangle of cells on a single sheet. > > **relative path**: A path that is implied by the active working directory or is calculated based on a specified directory. If users enter a command that refers to a file and the full path is not entered, the active working directory is the relative path of the referenced file. > > **smart document**: A file that is programmed to assist the user as the user creates or updates the document. Several types of files, such as forms and templates, can also function as smart documents. > > **smart tag**: A feature that adds the ability to recognize and label specific data types, such as people's names, within a document and displays an action button that enables users to perform common tasks for that data type. > > **smart tag recognizer**: An [**add-in**](#gt_a3be101e-9d37-484a-a5e6-b70d559146c6) that can interpret a specific type of smart tag, such as an address or a financial symbol, in a document and display an action button that enables users to perform common tasks for that data type. > > **SplitButtonMRUPopup control**: A type of [**SplitButtonPopup control**](#gt_1c046ab6-2530-4a41-8d19-03f92914beaf) whose icon changes to reflect the command that the user most recently selected from the menu that is displayed by that button. > > **SplitButtonPopup control**: A type of Button control that performs an action when clicked, and can also display a menu of related commands when the user clicks a drop-down arrow that appears on the button. > > **SplitDropDown control**: A type of Button control that performs a default action when clicked, and can also expand to display a list of other possible actions when the user clicks a drop-down arrow that appears on the button. > > **storage**: 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\]](%5bMS-CFB%5d.pdf#Section_53989ce47b054f8d829bd08d6148375b). > > **stream**: An element of a compound file, as described in \[MS-CFB\]. A stream contains a sequence of bytes that can be read from or written to by an application, and they can exist only in storages. > > **target frame**: The name of a frame that is in an HTML-based frames page and displays the destination of a hyperlink. > > **thumbnail**: A miniature version of an image that is typically used to browse multiple images quickly. > > **time stamp authority**: A service acknowledging that a datum existed before a specific time. The service is typically a trusted third party. > > **timestamp**: A condition of a [**digital signature**](#gt_ad0cf6e3-05c3-482d-ab0f-617f91871189) that indicates whether the signature was created with a valid certificate that has expired or was created with a certificate that had expired already. If the certificate expired after the signature was created, the signature can be trusted. If it expired before the signature was created, it cannot be trusted. > > **toolbar**: A row, column, or block of controls that represent tasks or commands within an application. A toolbar can be either a menu toolbar, which provides access to menu commands, or a [**basic toolbar**](#gt_39d82905-44bc-438d-9b2d-a2cd633a9dd9), which contains buttons that provide shortcuts to tasks that are frequently accessed from menus. > > **toolbar control**: An object that appears on a toolbar and enables user interaction or input, typically to initiate an action, display information, or set values. > > **toolbar control identifier (TCID)**: An integer that identifies a specific control on a toolbar. > > **toolbar control separator**: A line that separates groups of controls on a user interface surface, such as controls on a toolbar or commands on a menu. > > **toolbar control type**: A set of pre-defined behaviors and user interface elements for an object that can be implemented on a toolbar. Types include: ActiveX; Button; ButtonPopup; ComboBox; DropDown; Edit; ExpandingGrid; Gauge; GraphicCombo; GraphicDropDown; Grid; Label; OCXDropDown; Popup; SplitButtonPopup; SplitButtonMRUPopup; and SplitDropDown. > > **toolbar delta**: A file component that stores a modification that a user made to a built-in toolbar. Stored modifications include adding, changing, or removing a control from a built-in toolbar. > > **tooltip**: A window displaying text that is created when the mouse is moved over a window or notification icon. > > **top-level toolbar**: A [**basic toolbar**](#gt_39d82905-44bc-438d-9b2d-a2cd633a9dd9) that is not contained by another [**toolbar**](#gt_c57c58f2-a71c-4dc0-ae75-471d52b62f13). > > **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). > > **Uniform Resource Identifier (URI)**: A string that identifies a resource. The URI is an addressing mechanism defined in Internet Engineering Task Force (IETF) Uniform Resource Identifier (URI): Generic Syntax [\[RFC3986\]](https://go.microsoft.com/fwlink/?LinkId=90453). > > **Uniform Resource Locator (URL)**: A string of characters in a standardized format that identifies a document or resource on the World Wide Web. The format is as specified in [\[RFC1738\]](https://go.microsoft.com/fwlink/?LinkId=90287). > > **Universal Naming Convention (UNC)**: A string format that specifies the location of a resource. For more information, see [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) section 2.2.57. > > **URI fragment**: The portion of a [**Uniform Resource Identifier (URI)**](#gt_e18af8e8-01d7-4f91-8a1e-0fb21b191f95) that allows indirect identification of a secondary resource by reference to a primary resource and additional identifying information, as described in \[RFC3986\]. A fragment component is indicated by a number sign (#) and is terminated by the end of the URI. > > **URI query**: The portion of a [**Uniform Resource Identifier (URI)**](#gt_e18af8e8-01d7-4f91-8a1e-0fb21b191f95) that, in conjunction with the data in the path component, identifies a resource within the scope of a URI's scheme and naming authority, if any, as described in \[RFC3986\]. A query component is indicated by the first question mark (?) character and is terminated by a number sign (#) or the end of the URI. > > **URI scheme**: The portion of a [**Uniform Resource Identifier (URI)**](#gt_e18af8e8-01d7-4f91-8a1e-0fb21b191f95) that refers to a specification for assigning identifiers within the URI, as described in \[RFC3986\]. > > **URL moniker**: A Component Object Model (COM) object that stores a [**Uniform Resource Locator (URL)**](#gt_433a4fb7-ef84-46b0-ab65-905f5e3a80b1) as a string, based on either a full URL or the combination of a [**base URL**](#gt_4c44eaed-bf47-4788-a856-dcf7e55c8f0e) and a partial URL string. > > **Visual Basic for Applications (VBA)**: A macro-based programming language that derives from Microsoft Visual Basic and can be used to customize and extend an application. Unlike Visual Basic, Microsoft Visual Basic for Applications (VBA) code and macros can be run only from within a host application that supports VBA. > > **whitespace**: A character that can be found between words, including a space (" "), a carriage return in combination with a line feed (newline), and a tab character. > > **XML expansion pack**: A collection of files, managed by a manifest.xml file, that adds functionality to a document by specifying custom displays or actions. > > **XML namespace**: A collection of names that is used to identify elements, types, and attributes in XML documents identified in a URI reference \[RFC3986\]. A combination of XML namespace and local name allows XML documents to use elements, types, and attributes that have the same names but come from different sources. For more information, see [\[XMLNS-2ED\]](https://go.microsoft.com/fwlink/?LinkId=90602). > > **XML schema**: A description of a type of XML document that is typically expressed in terms of constraints on the structure and content of documents of that type, in addition to the basic syntax constraints that are imposed by XML itself. An XML schema provides a view of a document type at a relatively high level of abstraction. > > **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. \[ECMA-376\] ECMA International, "Office Open XML File Formats", [https://www.ecma-international.org/publications-and-standards/standards/ecma-376/](https://go.microsoft.com/fwlink/?LinkId=200054) \[ITUX680\] ITU-T, "Abstract Syntax Notation One (ASN.1): Specification of Basic Notation", Recommendation X.680, Approved 2021-02-13, [https://www.itu.int/rec/T-REC-X.680-202102-I/en](https://go.microsoft.com/fwlink/?LinkId=89923) \[MS-CTDOC\] Microsoft Corporation, "[Word Custom Toolbar Binary File Format](%5bMS-CTDOC%5d.pdf#Section_aff21c961b434bcf8c8a677e012c7e6a)". \[MS-CTXLS\] Microsoft Corporation, "[Excel Custom Toolbar Binary File Format](%5bMS-CTXLS%5d.pdf#Section_b461dcd9933e471081bcdc1c74801b6b)". \[MS-DOC\] Microsoft Corporation, "[Word (.doc) Binary File Format](%5bMS-DOC%5d.pdf#Section_ccd7b4867881484ca13751170af7cc22)". \[MS-DTYP\] Microsoft Corporation, "[Windows Data Types](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2)". \[MS-EMF\] Microsoft Corporation, "[Enhanced Metafile Format](%5bMS-EMF%5d.pdf#Section_91c257d7c39d4a369b1f63e3f73d30ca)". \[MS-IPFF\] Microsoft Corporation, "[InfoPath Form Template Format](%5bMS-IPFF%5d.pdf#Section_93482ffc8be24c288de5324a835e66b1)". \[MS-LCID\] Microsoft Corporation, "[Windows Language Code Identifier (LCID) Reference](%5bMS-LCID%5d.pdf#Section_70feba9f294e491eb6eb56532684c37f)". \[MS-LISTSWS\] Microsoft Corporation, "[Lists Web Service Protocol](%5bMS-LISTSWS%5d.pdf#Section_30b364cc38374e839ce81963292e2ee5)". \[MS-ODRAW\] Microsoft Corporation, "[Office Drawing Binary File Format](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872)". \[MS-OFFCRYPTO\] Microsoft Corporation, "[Office Document Cryptography Structure](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083)". \[MS-OFORMS\] Microsoft Corporation, "[Office Forms Binary File Formats](%5bMS-OFORMS%5d.pdf#Section_9c79701a8c3e4429a139b60ac3a1d50a)". \[MS-OI29500\] Microsoft Corporation, "[Office Implementation Information for ISO/IEC 29500 Standards Support](%5bMS-OI29500%5d.pdf#Section_1fd4a662862349c082f018fa91b413b8)". \[MS-OLEPS\] Microsoft Corporation, "[Object Linking and Embedding (OLE) Property Set Data Structures](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc)". \[MS-OVBA\] Microsoft Corporation, "[Office VBA File Format Structure](%5bMS-OVBA%5d.pdf#Section_575462babf6741909facc275523c75fc)". \[MS-OXCDATA\] Microsoft Corporation, "[Data Structures](%5bMS-OXCDATA%5d.pdf#Section_1afa0cd9b1a04520b623bf15030af5d8)". \[MS-OXPROPS\] Microsoft Corporation, "[Exchange Server Protocols Master Property List](%5bMS-OXPROPS%5d.pdf#Section_f6ab1613aefe447da49c18217230b148)". \[MS-WMF\] Microsoft Corporation, "[Windows Metafile Format](%5bMS-WMF%5d.pdf#Section_4813e7fd52d04f42965f228c8b7488d2)". \[MS-WSSCAML\] Microsoft Corporation, "[Collaborative Application Markup Language (CAML) Structure](%5bMS-WSSCAML%5d.pdf#Section_8d6156fd646842949594644a946ed6a6)". \[MS-XLS\] Microsoft Corporation, "[Excel Binary File Format (.xls) Structure](%5bMS-XLS%5d.pdf#Section_cd03cb5fca024934a391bb674cb8aa06)". \[PKCS7\] RSA Laboratories, "PKCS \#7: Cryptographic Message Syntax Standard", PKCS \#7, version 1.5, November 1993 (\[RFC2315\], March 1998), [https://www.rfc-editor.org/info/rfc2315](https://go.microsoft.com/fwlink/?LinkId=510681) **Note** Original Archived. \[PKCS9\] RSA Laboratories, "PKCS \#9: Selected Attribute Types", PKCS \#9, version 1.1, November 1993, [http://www.emc.com/emc-plus/rsa-labs/standards-initiatives/pkcs-9-selected-attribute-types.htm](https://go.microsoft.com/fwlink/?LinkId=510682) \[RFC1321\] Rivest, R., "The MD5 Message-Digest Algorithm", RFC 1321, April 1992, [https://www.rfc-editor.org/info/rfc1321](https://go.microsoft.com/fwlink/?LinkId=90275) \[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) \[RFC3280\] Housley, R., Polk, W., Ford, W., and Solo, D., "Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile", RFC 3280, April 2002, [http://www.rfc-editor.org/info/rfc3280](https://go.microsoft.com/fwlink/?LinkId=90414) \[RFC3986\] Berners-Lee, T., Fielding, R., and Masinter, L., "Uniform Resource Identifier (URI): Generic Syntax", STD 66, RFC 3986, January 2005, [https://www.rfc-editor.org/info/rfc3986](https://go.microsoft.com/fwlink/?LinkId=90453) \[RFC5234\] Crocker, D., Ed., and Overell, P., "Augmented BNF for Syntax Specifications: ABNF", STD 68, RFC 5234, January 2008, [https://www.rfc-editor.org/info/rfc5234](https://go.microsoft.com/fwlink/?LinkId=123096) \[W3C-XSD\] World Wide Web Consortium, "XML Schema Part 2: Datatypes Second Edition", 28 October 2004, [http://www.w3.org/TR/2004/REC-xmlschema-2-20041028](https://go.microsoft.com/fwlink/?LinkId=90563) ### Informative References \[MS-PPT\] Microsoft Corporation, "[PowerPoint (.ppt) Binary File Format](%5bMS-PPT%5d.pdf#Section_6be79dde33c14c1b8ccc4b2301c08662)". \[MSDN-AVSTOS\] Microsoft Corporation, "Architecture of Visual Studio Tools for Office Solutions", [http://msdn.microsoft.com/en-us/library/zkhw8h59(VS.80).aspx](https://go.microsoft.com/fwlink/?LinkId=121211) \[MSDN-CreateUri\] Microsoft Corporation, "CreateUri Function", [http://msdn.microsoft.com/en-us/library/ms775098(VS.85).aspx](https://go.microsoft.com/fwlink/?LinkId=120601) \[MSDN-FM\] Microsoft Corporation, "File Monikers", [http://msdn.microsoft.com/en-us/library/ms688670(VS.85).aspx](https://go.microsoft.com/fwlink/?LinkId=121362) \[MSDN-IMAMI\] Microsoft Corporation, "IMoniker -- Anti-Moniker Implementation", [http://msdn.microsoft.com/en-us/library/ms682346(VS.85).aspx](https://go.microsoft.com/fwlink/?LinkId=121364) \[MSDN-IMCOM\] Microsoft Corporation, "Item Monikers (COM)", [http://msdn.microsoft.com/en-us/library/ms693722(VS.85).aspx](https://go.microsoft.com/fwlink/?LinkId=121361) \[MSDN-IMGCMI\] Microsoft Corporation, "IMoniker -- Generic Composite Moniker Implementation", [http://msdn.microsoft.com/en-us/library/ms688541(VS.85).aspx](https://go.microsoft.com/fwlink/?LinkId=121363) \[MSDN-SDO\] Microsoft Corporation, "Smart Documents Overview", Office 2003 Smart Document Software Development Kit, [http://msdn.microsoft.com/en-us/library/aa193956(office.11).aspx](https://go.microsoft.com/fwlink/?LinkId=120839) \[MSDN-URLM\] Microsoft Corporation, "URL Monikers", [http://msdn.microsoft.com/en-us/library/ms688580(VS.85).aspx](https://go.microsoft.com/fwlink/?LinkId=121360) ## Structure Overview (Synopsis) The following sections provide an overview of the structure of this protocol. ### Toolbar Customization [**Toolbar**](#gt_c57c58f2-a71c-4dc0-ae75-471d52b62f13) customization structures provide a run-time solution for the creation and deployment of toolbar customizations that are specific to the content of a file. The following diagram illustrates how toolbar customization structures are presented within the XCB binary [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6), as described in [\[MS-XLS\]](%5bMS-XLS%5d.pdf#Section_cd03cb5fca024934a391bb674cb8aa06) section 2.1.7.10 with its toolbar customization structures. ![Toolbar customization structures in an XCB binary stream](media/image1.bin "Toolbar customization structures in an XCB binary stream") Figure 1: Toolbar customization structures in an XCB binary stream The following diagram illustrates how toolbar customization structures are presented within the Table Stream, as described in [\[MS-DOC\]](%5bMS-DOC%5d.pdf#Section_ccd7b4867881484ca13751170af7cc22) section 2.1.2. ![Toolbar customization structures in a Table Stream](media/image2.bin "Toolbar customization structures in a Table Stream") Figure 2: Toolbar customization structures in a Table Stream ### Property Set Storage [**OLE Property Sets**](#Section_0105a8ee6e664b1281a5d3d39c8270f2) (section 2.3.3.2) define a common way to store metadata about a file. The [**Summary Information Property Set**](#Section_11b5612735f44bfaa23f23935a6edf54) (section 2.3.3.2.1) and [**Document Summary Information Property Set**](#Section_fe59ffd979e944fba1c92466057b05c6) (section 2.3.3.2.2) contain a predefined set of properties, storing information such as title, subject, keywords, author, and line count. The [User Defined Property Set](#Section_54514afbff194348be71395854d4432d) (section 2.3.3.2.3) contains a set of properties that an application or user can extend. The following two diagrams illustrate the structure of these property sets as persisted to a binary file. These property sets are implementations of [**OLE**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) Property Sets. For a structural overview of OLE Property Sets, see [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [1.3](http://msdn.microsoft.com/en-us/library/df2e0abe-365f-4bf8-a630-6c1f560238c8/). ![Property set storage structure](media/image3.bin "Property set storage structure") Figure 3: Property set storage structure ![Property set packet structure](media/image4.bin "Property set packet structure") Figure 4: Property set packet structure ### RefEdit Control A [**RefEdit**](#Section_45556c0e0f424c79864e503cd04e38ba) control (section 2.3.5) displays a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) value that references [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in a [**datasheet**](#gt_044a2880-814e-4b2f-b3eb-e5d78d499896). A user can enter the value into the control directly or click a drop-down box to select it. The format of the range value depends on the datasheet implementation. ### Visual Basic for Applications Digital Signature The **[Visual Basic for Applications (VBA)](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) [digital signature structure](#Section_f80ee18cd72f4c3c9ea5a56f396322e0)** (section 2.3.2) is contained in a wrapping structure that is specific to the mechanism the file format uses to store the signature. In the formats described in [\[MS-XLS\]](%5bMS-XLS%5d.pdf#Section_cd03cb5fca024934a391bb674cb8aa06) and [\[MS-PPT\]](%5bMS-PPT%5d.pdf#Section_6be79dde33c14c1b8ccc4b2301c08662), the signature structure is stored in the [**Document Summary Information OLE property set**](#Section_3ef02e83afef4b6c9585c109edd24e07) (section 2.3.3.2.2.1) as a VT_BLOB **TypedPropertyValue** property. The following diagram illustrates the relative structures for this storage mechanism. ![VBA digital signature storage as OLE property set property](media/image5.bin "VBA digital signature storage as OLE property set property") Figure 5: VBA digital signature storage as OLE property set property In the format described in [\[MS-DOC\]](%5bMS-DOC%5d.pdf#Section_ccd7b4867881484ca13751170af7cc22), the signature structure is stored in the StwUser string table (\[MS-DOC\] section 2.9.298) as the value of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string variables named "Sign" or "SigAgile". The following diagram illustrates the relative structures for this storage mechanism. ![VBA digital signature storage as \[MS-DOC\] string table variable](media/image6.bin "VBA digital signature storage as [MS-DOC] string table variable") Figure 6: VBA digital signature storage as \[MS-DOC\] string table variable The signature structure consists of information about the [**digital signature**](#gt_ad0cf6e3-05c3-482d-ab0f-617f91871189), as well as the signature (section [2.3.2.4](#Section_7c4ce2e22a714b028f51b9f0eeed756a)) itself, and a [serialized certificate store](#Section_e88d644c80f84016a2c093fc5b110877) (section 2.3.2.5.5). The following diagram illustrates this structure. ![DigSigInfoSerialized structure](media/image7.bin "DigSigInfoSerialized structure") Figure 7: DigSigInfoSerialized structure ### Byte Ordering Data in the Office Common Data Types and Objects Structure is stored in [**little-endian**](#gt_079478cb-f4c5-4ce5-b72b-2144da5d2ce7) format. Some computer architectures number bytes in a binary word from left to right, which is referred to as [**big-endian**](#gt_6f6f9e8e-5966-4727-8527-7e02fb864e7e). The packet diagrams for this documentation are big-endian. Other architectures number the bytes in a binary word from right to left, which is referred to as little-endian. The underlying file format enumerations, objects, and records are little-endian. Using big-endian and little-endian methods, the number 0x12345678 would be stored as shown in the following table. | Byte order | Byte 0 | Byte 1 | Byte 2 | Byte 3 | |---------------|--------|--------|--------|--------| | Big-endian | 0x12 | 0x34 | 0x56 | 0x78 | | Little-endian | 0x78 | 0x56 | 0x34 | 0x12 | ## Relationship to Protocols and Other Structures ### Toolbar Customization The **CTB** and **TBC** structures described in [\[MS-XLS\]](%5bMS-XLS%5d.pdf#Section_cd03cb5fca024934a391bb674cb8aa06) section 2.6, and the **CTB** and **TBC** structures described in [\[MS-DOC\]](%5bMS-DOC%5d.pdf#Section_ccd7b4867881484ca13751170af7cc22) section 2.9 depend on the toolbar customization structures specified in this document. The [**TBCHeader**](#Section_6fec0363d40148aaacdf46b7a8bf31db) (section 2.3.1.10), [**TBCSFlags**](#Section_df3f6f9b34c6451fad13765c2cb63c09) (section 2.3.1.12), and [**TBCMenuSpecific**](#Section_912bf645a367471b9d4efc29583a01bc) (section 2.3.1.21) structures specified in this document are dependent on the toolbar customization data described in the following references: - - ### [\[MS-CTDOC\]](%5bMS-CTDOC%5d.pdf#Section_aff21c961b434bcf8c8a677e012c7e6a) for the persistence format for word processing documents.[\[MS-CTXLS\]](%5bMS-CTXLS%5d.pdf#Section_b461dcd9933e471081bcdc1c74801b6b) for the persistence format for spreadsheet [**toolbar**](#gt_c57c58f2-a71c-4dc0-ae75-471d52b62f13) customization structures defined in this document. Property Set Storage The [**OLE Property Sets**](#Section_0105a8ee6e664b1281a5d3d39c8270f2) (section 2.3.3.2) specified in this document are implementations of [**Object Linking and Embedding (OLE)**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) Property Set Data Structures (OLEPS) as described in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc). This document describes where [\[MS-DOC\]](%5bMS-DOC%5d.pdf#Section_ccd7b4867881484ca13751170af7cc22), [\[MS-PPT\]](%5bMS-PPT%5d.pdf#Section_6be79dde33c14c1b8ccc4b2301c08662), and [\[MS-XLS\]](%5bMS-XLS%5d.pdf#Section_cd03cb5fca024934a391bb674cb8aa06) file formats extend \[MS-OLEPS\] and where they deviate from \[MS-OLEPS\]. These property sets are contained in persistence formats described in \[MS-XLS\], \[MS-DOC\], and \[MS-PPT\]. Some data in the property sets is generated according to algorithms specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872), \[MS-DOC\], and \[MS-XLS\]. ### Visual Basic for Applications Digital Signature The [**digital signature**](#gt_ad0cf6e3-05c3-482d-ab0f-617f91871189) for a [**VBA**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) project is a specific implementation of the PKCS \#7 Cryptographic Message Syntax Standard as described in [\[PKCS7\]](https://go.microsoft.com/fwlink/?LinkId=510681). Additional implementation information for attributes of the signature is described in [\[PKCS9\]](https://go.microsoft.com/fwlink/?LinkId=510682). The file formats [\[MS-XLS\]](%5bMS-XLS%5d.pdf#Section_cd03cb5fca024934a391bb674cb8aa06) and [\[MS-PPT\]](%5bMS-PPT%5d.pdf#Section_6be79dde33c14c1b8ccc4b2301c08662) store their VBA digital signature in their [**OLE Property Sets**](#Section_0105a8ee6e664b1281a5d3d39c8270f2) (section 2.3.3.2). The file format [\[MS-DOC\]](%5bMS-DOC%5d.pdf#Section_ccd7b4867881484ca13751170af7cc22) stores the VBA digital signature in a string table within the document. The data that the VBA digital signature encrypts is described in the [\[MS-OVBA\]](%5bMS-OVBA%5d.pdf#Section_575462babf6741909facc275523c75fc) specification. ## Applicability Statement The structures in this document are intended to function as persistence formats for portions of a document, and are not intended for stand-alone use. These persistence formats provide interoperability with applications that create or read documents conforming to this structure[\<1\>](#Appendix_A_1). ### Toolbar Customization [**Toolbar**](#gt_c57c58f2-a71c-4dc0-ae75-471d52b62f13) customization structures represent a common model for storing [**custom toolbars**](#gt_6ee69c13-ffa9-43b1-989e-a942dceb1fa5) or toolbar alterations within the [\[MS-DOC\]](%5bMS-DOC%5d.pdf#Section_ccd7b4867881484ca13751170af7cc22) and [\[MS-XLS\]](%5bMS-XLS%5d.pdf#Section_cd03cb5fca024934a391bb674cb8aa06) file formats. Toolbar customization structures can be used whenever it is desirable to have [**custom toolbar controls**](#gt_75556eac-bd5a-4dc2-b7b5-48c27bfa1c93) (for example, custom toolbar controls that run custom macros) travel with a file from one system to another. ### Property Set Storage **OLE Property Sets** (section [2.3.3.2](#Section_0105a8ee6e664b1281a5d3d39c8270f2)) represent a common way to store metadata about a file within the [\[MS-DOC\]](%5bMS-DOC%5d.pdf#Section_ccd7b4867881484ca13751170af7cc22), [\[MS-PPT\]](%5bMS-PPT%5d.pdf#Section_6be79dde33c14c1b8ccc4b2301c08662), and [\[MS-XLS\]](%5bMS-XLS%5d.pdf#Section_cd03cb5fca024934a391bb674cb8aa06) file formats in a way that is discoverable to other software. ### Visual Basic for Applications Digital Signature The [**digital signature**](#gt_ad0cf6e3-05c3-482d-ab0f-617f91871189) for a [**VBA**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) project represents a way to securely identify the author of the executable VBA code that is associated with the document by means of a public [**digital certificate**](#gt_a1dfa70d-7803-413d-8697-c40021a3f3d0). By securely identifying the author, a future user of the document can make a decision to trust or reject the executable document content based on the signer’s identity. A digital signature also allows a future user to determine whether the content of the document’s executable code is no longer the same as the code that was originally signed, which means that the code can no longer be trusted to have come from the signer identified by the accompanying digital certificate. ## Versioning and Localization ### Toolbar Customization This document covers versioning issues in the following areas: - - ### **Structure Versions:** There is only one version of the [**toolbar**](#gt_c57c58f2-a71c-4dc0-ae75-471d52b62f13) customization structures (section [2.3.1](#Section_a38b2b42f81045358ffb175863574222)).**Localization:** The toolbar customization structures define no [**locale**](#gt_7b78ebef-e35d-45ab-abfd-4121b60995de)-specific processes or data.Property Set Storage This document covers versioning issues in the following areas: - - ### **Structure Versions:** There is only one version of the property sets defined in [**Property Set Storage**](#Section_9673a168c71544eb882502cfa2b4627d) (section 2.3.3).**Localization:** The encoding of strings contained in the [**Lpstr**](#Section_fac324c9ff39442ebd181a91a723a818) (section 2.3.3.1.4) data type and the [**UnalignedLpstr**](#Section_a8f75582c3d34a5bbbca62ed6a05711d) (section 2.3.3.1.5) data type depend on the property set’s **CodePage** property (described in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.18.2](http://msdn.microsoft.com/en-us/library/b8910736-7f4a-469a-9644-aed68a71d7d1/)).Visual Basic for Applications Digital Signature This document covers versioning issues in the following areas: - - ## **Structure Versions:** There is only one version of the [**VBA**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) [**digital signature**](#gt_ad0cf6e3-05c3-482d-ab0f-617f91871189) defined in [Visual Basic for Applications Digital Signature Storage](#Section_f80ee18cd72f4c3c9ea5a56f396322e0) (section 2.3.2).**Localization:** The VBA digital signature structures define no [**locale**](#gt_7b78ebef-e35d-45ab-abfd-4121b60995de)-specific processes or data.Vendor-Extensible Fields The following sections describe the vendor-extensible fields used by this protocol. ### Toolbar Customization None. ### Property Set Storage None. ### Visual Basic for Applications Digital Signature Extensibility is as described in the [\[PKCS7\]](https://go.microsoft.com/fwlink/?LinkId=510681) specification, except the constraints in, VBA Digital Signature (section [2.3.2.4](#Section_7c4ce2e22a714b028f51b9f0eeed756a)). # Structures ## Common ABNF Definitions The following are common ABNF ([\[RFC5234\]](https://go.microsoft.com/fwlink/?LinkId=123096)) definitions for the standard ASCII and [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters. 1. ASCII-SPACE = %x20 ASCII-EXCLAMATION-MARK = %x21 ASCII-QUOTATION-MARK = %x22 ASCII-NUMBER-SIGN = %x23 ASCII-DOLLAR-SIGN = %x24 ASCII-PERCENT-SIGN = %x25 ASCII-AMPERSAND = %x26 ASCII-APOSTROPHE = %x27 ASCII-LEFT-PARENTHESIS = %x28 ASCII-RIGHT-PARENTHESIS = %x29 ASCII-ASTERISK = %x2A ASCII-PLUS-SIGN = %x2B ASCII-COMMA = %x2C ASCII-HYPHEN-MINUS = %x2D ASCII-FULL-STOP = %x2E ASCII-SOLIDUS = %x2F ASCII-DIGIT-ZERO = %x30 ASCII-DIGIT-ONE = %x31 ASCII-DIGIT-TWO = %x32 ASCII-DIGIT-THREE = %x33 ASCII-DIGIT-FOUR = %x34 ASCII-DIGIT-FIVE = %x35 ASCII-DIGIT-SIX = %x36 ASCII-DIGIT-SEVEN = %x37 ASCII-DIGIT-EIGHT = %x38 ASCII-DIGIT-NINE = %x39 ASCII-COLON = %x3A ASCII-SEMICOLON = %x3B ASCII-LESS-THAN-SIGN = %x3C ASCII-EQUALS-SIGN = %x3D ASCII-GREATER-THAN-SIGN = %x3E ASCII-QUESTION-MARK = %x3F ASCII-COMMERCIAL-AT = %x40 ASCII-CAPITAL-LETTER-A = %x41 ASCII-CAPITAL-LETTER-B = %x42 ASCII-CAPITAL-LETTER-C = %x43 ASCII-CAPITAL-LETTER-D = %x44 ASCII-CAPITAL-LETTER-E = %x45 ASCII-CAPITAL-LETTER-F = %x46 ASCII-CAPITAL-LETTER-G = %x47 ASCII-CAPITAL-LETTER-H = %x48 ASCII-CAPITAL-LETTER-I = %x49 ASCII-CAPITAL-LETTER-J = %x4A ASCII-CAPITAL-LETTER-K = %x4B ASCII-CAPITAL-LETTER-L = %x4C ASCII-CAPITAL-LETTER-M = %x4D ASCII-CAPITAL-LETTER-N = %x4E ASCII-CAPITAL-LETTER-O = %x4F ASCII-CAPITAL-LETTER-P = %x50 ASCII-CAPITAL-LETTER-Q = %x51 ASCII-CAPITAL-LETTER-R = %x52 ASCII-CAPITAL-LETTER-S = %x53 ASCII-CAPITAL-LETTER-T = %x54 ASCII-CAPITAL-LETTER-U = %x55 ASCII-CAPITAL-LETTER-V = %x56 ASCII-CAPITAL-LETTER-W = %x57 ASCII-CAPITAL-LETTER-X = %x58 ASCII-CAPITAL-LETTER-Y = %x59 ASCII-CAPITAL-LETTER-Z = %x5A ASCII-LEFT-SQUARE-BRACKET = %x5B ASCII-REVERSE-SOLIDUS = %x5C ASCII-RIGHT-SQUARE-BRACKET = %x5D ASCII-CIRCUMFLEX-ACCENT = %x5E ASCII-LOW-LINE = %x5F ASCII-GRAVE-ACCENT = %x60 ASCII-SMALL-LETTER-A = %x61 ASCII-SMALL-LETTER-B = %x62 ASCII-SMALL-LETTER-C = %x63 ASCII-SMALL-LETTER-D = %x64 ASCII-SMALL-LETTER-E = %x65 ASCII-SMALL-LETTER-F = %x66 ASCII-SMALL-LETTER-G = %x67 ASCII-SMALL-LETTER-H = %x68 ASCII-SMALL-LETTER-I = %x69 ASCII-SMALL-LETTER-J = %x6A ASCII-SMALL-LETTER-K = %x6B ASCII-SMALL-LETTER-L = %x6C ASCII-SMALL-LETTER-M = %x6D ASCII-SMALL-LETTER-N = %x6E ASCII-SMALL-LETTER-O = %x6F ASCII-SMALL-LETTER-P = %x70 ASCII-SMALL-LETTER-Q = %x71 ASCII-SMALL-LETTER-R = %x72 ASCII-SMALL-LETTER-S = %x73 ASCII-SMALL-LETTER-T = %x74 ASCII-SMALL-LETTER-U = %x75 ASCII-SMALL-LETTER-V = %x76 ASCII-SMALL-LETTER-W = %x77 ASCII-SMALL-LETTER-X = %x78 ASCII-SMALL-LETTER-Y = %x79 ASCII-SMALL-LETTER-Z = %x7A ASCII-LEFT-CURLY-BRACKET = %x7B ASCII-VERTICAL-LINE = %x7C ASCII-RIGHT-CURLY-BRACKET = %x7D ASCII-TILDE = %x7E ASCII-DELETE = %x7F ASCII-CRLF = %x0d.0a ASCII-DIGIT = ASCII-DIGIT-ZERO / ASCII-DIGIT-ONE / ASCII-DIGIT-TWO / ASCII-DIGIT-THREE / ASCII-DIGIT-FOUR / ASCII-DIGIT-FIVE / ASCII-DIGIT-SIX / ASCII-DIGIT-SEVEN / ASCII-DIGIT-EIGHT / ASCII-DIGIT-NINE ASCII-DIGIT-HEXADECIMAL = ASCII-DIGIT / ASCII-SMALL-LETTER-A / ASCII-SMALL-LETTER-B / ASCII-SMALL-LETTER-C / ASCII-SMALL-LETTER-D / ASCII-SMALL-LETTER-E / ASCII-SMALL-LETTER-F / ASCII-CAPITAL-LETTER-A / ASCII-CAPITAL-LETTER-B / ASCII-CAPITAL-LETTER-C / ASCII-CAPITAL-LETTER-D / ASCII-CAPITAL-LETTER-E / ASCII-CAPITAL-LETTER-F ASCII-ALL = %x20-7F UTF16-CHAR-NON-ASCII = %x0080-FFFF UTF16-ANY = ASCII-ALL / UTF16-CHAR-NON-ASCII ## Data Types ### Common Data Types #### ObjectUpdateEnum Specifies how the container updates the [**linked object**](#gt_cfc45e76-9219-4c47-9ef2-5832a172f795) embedded in an application. | Name | Value | Meaning | |----|----|----| | **OU_Always** | 0x00000001 | The container updates the linked object whenever there is an update associated with it. | | **OU_OnCall** | 0x00000003 | The container updates the linked object only when the container calls its update method. | #### DataViewAspectEnum Specifies the desired data or view aspect of the [**object**](#gt_8bb43a65-7a8c-4585-a7ed-23044772f8ca) when drawing or obtaining data. | Name | Value | Meaning | |----|----|----| | **OR_Content** | 0x00000001 | Specifies that the object is displayed as an embedded object inside of a container. | | **OR_Thumbnail** | 0x00000002 | Specifies that the object is displayed as a [**thumbnail**](#gt_811d0e6b-538c-487d-a54f-44f31e41e172) image. | | **OR_Icon** | 0x00000004 | Specifies that the object is displayed as an icon. | | **OR_DocPrint** | 0x00000008 | Specifies that the object is displayed on the screen as though it were printed to a printer. | #### MSONFC This specifies the list of numbering formats that can be used for a group of automatically numbered objects. The numbering format values are mapped to the ST_NumberFormat ([\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) partition IV section 2.18.66) enumeration equivalents as described in the following table. | Name | Value | Meaning | |----|----|----| | **msonfcArabic** | 0x00 | decimal | | **msonfcUCRoman** | 0x01 | upperRoman | | **msonfcLCRoman** | 0x02 | lowerRoman | | **msonfcUCLetter** | 0x03 | upperLetter | | **msonfcLCLetter** | 0x04 | lowerLetter | | **msonfcOrdinal** | 0x05 | ordinal | | **msonfcCardtext** | 0x06 | cardinalText | | **msonfcOrdtext** | 0x07 | ordinalText | | **msonfcHex** | 0x08 | hex | | **msonfcChiManSty** | 0x09 | chicago | | **msonfcDbNum1** | 0x0A | ideographDigital | | **msonfcDbNum2** | 0x0B | japaneseCounting | | **msonfcAiueo** | 0x0C | Aiueo | | **msonfcIroha** | 0x0D | Iroha | | **msonfcDbChar** | 0x0E | decimalFullWidth | | **msonfcSbChar** | 0x0F | decimalHalfWidth | | **msonfcDbNum3** | 0x10 | japaneseLegal | | **msonfcDbNum4** | 0x11 | japaneseDigitalTenThousand | | **msonfcCirclenum** | 0x12 | decimalEnclosedCircle | | **msonfcDArabic** | 0x13 | decimalFullWidth2 | | **msonfcDAiueo** | 0x14 | aiueoFullWidth | | **msonfcDIroha** | 0x15 | irohaFullWidth | | **msonfcArabicLZ** | 0x16 | decimalZero | | **msonfcBullet** | 0x17 | bullet | | **msonfcGanada** | 0x18 | ganada | | **msonfcChosung** | 0x19 | chosung | | **msonfcGB1** | 0x1A | decimalEnclosedFullstop | | **msonfcGB2** | 0x1B | decimalEnclosedParen | | **msonfcGB3** | 0x1C | decimalEnclosedCircleChinese | | **msonfcGB4** | 0x1D | ideographEnclosedCircle | | **msonfcZodiac1** | 0x1E | ideographTraditional | | **msonfcZodiac2** | 0x1F | ideographZodiac | | **msonfcZodiac3** | 0x20 | ideographZodiacTraditional | | **msonfcTpeDbNum1** | 0x21 | taiwaneseCounting | | **msonfcTpeDbNum2** | 0x22 | ideographLegalTraditional | | **msonfcTpeDbNum3** | 0x23 | taiwaneseCountingThousand | | **msonfcTpeDbNum4** | 0x24 | taiwaneseDigital | | **msonfcChnDbNum1** | 0x25 | chineseCounting | | **msonfcChnDbNum2** | 0x26 | chineseLegalSimplified | | **msonfcChnDbNum3** | 0x27 | chineseCountingThousand | | **msonfcChnDbNum4** | 0x28 | decimal | | **msonfcKorDbNum1** | 0x29 | koreanDigital | | **msonfcKorDbNum2** | 0x2A | koreanCounting | | **msonfcKorDbNum3** | 0x2B | koreanLegal | | **msonfcKorDbNum4** | 0x2C | koreanDigital2 | | **msonfcHebrew1** | 0x2D | hebrew1 | | **msonfcArabic1** | 0x2E | arabicAlpha | | **msonfcHebrew2** | 0x2F | hebrew2 | | **msonfcArabic2** | 0x30 | arabicAbjad | | **msonfcHindi1** | 0x31 | hindiVowels | | **msonfcHindi2** | 0x32 | hindiConsonants | | **msonfcHindi3** | 0x33 | hindiNumbers | | **msonfcHindi4** | 0x34 | hindiCounting | | **msonfcThai1** | 0x35 | thaiLetters | | **msonfcThai2** | 0x36 | thaiNumbers | | **msonfcThai3** | 0x37 | thaiCounting | | **msonfcViet1** | 0x38 | vietnameseCounting | | **msonfcNumInDash** | 0x39 | numberInDash | | **msonfcLCRus** | 0x3A | russianLower | | **msonfcUCRus** | 0x3B | russianUpper | | **msonfcNone** | 0xFF | Specifies that the sequence will not display any numbering | #### WebScreenSizeEnum An enumeration that specifies the screen resolution for the target monitor on which the Web page is to be displayed. Values are described in the following table. | Name | Value | Meaning | |--------------------------------|-------|---------------------| | **MSOWOPTScreenSize544x376** | 0x00 | 544 by 376 pixels | | **MSOWOPTScreenSizeWebTV** | 0x00 | 544 by 376 pixels | | **MSOWOPTScreenSize640x480** | 0x01 | 640 by 480 pixels | | **MSOWOPTScreenSize720x512** | 0x02 | 720 by 512 pixels | | **MSOWOPTScreenSize800x600** | 0x03 | 800 by 600 pixels | | **MSOWOPTScreenSize1024x768** | 0x04 | 1024 by 768 pixels | | **MSOWOPTScreenSize1152x882** | 0x05 | 1152 by 882 pixels | | **MSOWOPTScreenSize1152x900** | 0x06 | 1152 by 900 pixels | | **MSOWOPTScreenSize1280x1024** | 0x07 | 1280 by 1024 pixels | | **MSOWOPTScreenSize1600x1200** | 0x08 | 1600 by 1200 pixels | | **MSOWOPTScreenSize1800x1440** | 0x09 | 1800 by 1440 pixels | | **MSOWOPTScreenSize1920x1200** | 0x0A | 1920 by 1200 pixels | #### FilePointer Specifies the offset into the [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) or file that is to be read from or written to. **offset (4 bytes):** Unsigned integer that specifies the offset into a stream or file. #### FixedPoint Specifies an approximation of a real number, where the approximation has a fixed number of digits after the radix point. 129. Value of the real number = **Integral** + (**Fractional** / 65536.0) **Integral (2 bytes):** A signed integer that specifies the integral part of the real number. **Fractional (2 bytes):** An unsigned integer that specifies the fractional part of the real number. ## Common Objects ### Toolbar Customization This section specifies structures used by the **CTB**, and **TBC** structures specified in [\[MS-XLS\]](%5bMS-XLS%5d.pdf#Section_cd03cb5fca024934a391bb674cb8aa06) section 2.6, and by the **CTB**, and **TBC** structures specified in [\[MS-DOC\]](%5bMS-DOC%5d.pdf#Section_ccd7b4867881484ca13751170af7cc22) section 2.9. #### TBCBitmap *Referenced by: [TBCBSpecific](#Section_6f6f5f9fe2f04f0d9d6fb15395b364c0)* Specifies a bitmap used to store a custom icon used by a [**toolbar control**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d). [TABLE] **cbDIB (4 bytes):** Signed integer that specifies the count of total bytes, excluding this field, in the **TBCBitmap** structure plus 10. The value is given by the following formula: 130. **cbDIB** = sizeOf(**biHeader**) + sizeOf(**colors**) + sizeOf(**bitmapData**) + 10 The value MUST be greater than or equal to 40, and MUST be less than or equal to 65576 (which is a bitmap that is 128 pixels high, 128 pixels wide at 32 bits of color per pixel plus 40 ((128 \* 128 \* 32 / 8) + 40)). **biHeader (30 bytes):** A [**BITMAPINFOHEADER**](#Section_5eb5fc23797e4e428ef1ef844994d7d4) structure (section 2.3.1.2) that contains information about this bitmap. **colors (variable):** Zero-based array of [**RGBQuad**](#Section_635c7c9d5a7f45dc98c1577be7d0f7ac) structures (section 2.3.1.3). MUST exist only if **biHeader.biBitCount** is less than or equal to 0x08. The number of elements in this array MUST be equal to 2^biHeader.biBitCount. **bitmapData (variable):** An array of bytes as specified by the **aData** field of a **DeviceIndependentBitmap** object specified in [\[MS-WMF\]](%5bMS-WMF%5d.pdf#Section_4813e7fd52d04f42965f228c8b7488d2) section [2.2.2.9](http://msdn.microsoft.com/en-us/library/7376542a-cce9-4625-8ead-585e9538f9f1/). The number of bytes in this array MUST be equal to cbDIB – sizeOf(colors) – sizeOf(biHeader) -10. The number of bytes in this array is also calculated with the following formula: 131. Number of bytes in **bitmapData** = ((**biHeader.biWidth** \* **biHeader.biBitCount** + 31) & ~31) / 8 \* **biHeader.biHeight** #### BITMAPINFOHEADER *Referenced by: [TBCBitmap](#Section_24c6da6cfc9f4815ad189a7a3a6d9205)* Bitmap header. Contains information about a bitmap. [TABLE] **bData (4 bytes):** Unsigned integer. MUST be 0x00000028. **biWidth (2 bytes):** Signed integer that specifies the width of the bitmap in pixels. MUST be positive and less than or equal to 0x0080. **biHeight (2 bytes):** Signed integer that specifies the height of the bitmap in pixels. MUST be positive and less than or equal to 0x0080. **biPlanes (1 byte):** Unsigned integer that MUST be 0x01. **biBitCount (1 byte):** Unsigned integer that specifies the number of bits per pixel. MUST be equal to one of the values in the following table. | Value of biBitCount | |:-------------------:| | 0x01 | | 0x04 | | 0x08 | | 0x10 | | 0x18 | | 0x20 | **biCompression (2 bytes):** Unsigned integer that specifies the bitmap compression format. A value of 0x0000 means that the bitmap is uncompressed. The value MUST be 0x0000. **biSizeImage (2 bytes):** Unsigned integer that specifies the size, in bytes, of the image. The value SHOULD specify the size of the **bitmapData** array of the **TBCBitmap** structure (section 2.3.1.1) that contains this structure and is given by the following formula. For ​uncompressed bitmaps, this value is equal to 0x0000 and does not specify the size of the image. 132. biSizeImage = ((biHeader.biWidth \* biHeader.biBitCount + 31) & ~31) / 8 \* biHeader.biHeight **biXPelsPerMeter (4 bytes):** MUST be 0x00000000 and MUST be ignored. **biYPelsPerMeter (4 bytes):** MUST be 0x00000000 and MUST be ignored. **biClrUsed (4 bytes):** Unsigned integer as specified by the **ColorUsed** field of the **BitmapInfoHeader** object specified in [\[MS-WMF\]](%5bMS-WMF%5d.pdf#Section_4813e7fd52d04f42965f228c8b7488d2) section [2.2.2.3](http://msdn.microsoft.com/en-us/library/567172fa-b8a2-4d79-86a2-5e21d6659ef3/). MUST be 0x00000000. **biClrImportant (4 bytes):** Unsigned integer as specified by the **ColorImportant** field of the **BitmapInfoHeader** object specified in \[MS-WMF\] section 2.2.2.3. MUST be 0x00000000. #### RGBQuad *Referenced by: [TBCBitmap](#Section_24c6da6cfc9f4815ad189a7a3a6d9205)* Specifies the pixel color values in a **TBCBitmap** (section 2.3.1.1). [TABLE] **blue (1 byte):** An unsigned integer that specifies the relative intensity of blue. **green (1 byte):** An unsigned integer that specifies the relative intensity of green. **red (1 byte):** An unsigned integer that specifies the relative intensity of red. **reserved (1 byte):** Undefined and MUST be ignored. #### WString *Referenced by: [TB](#Section_4b59413771ec456fbaf9ba1dd0a28c5c), [TBCBSpecific](#Section_6f6f5f9fe2f04f0d9d6fb15395b364c0), [TBCCDData](#Section_aa9aecdd1d154724adecc1f6bd7e8c59), [TBCExtraInfo](#Section_feebb647ba9c40378718babc740201c5), [TBCGeneralInfo](#Section_99109267262941139ceca9481d6d606d), [TBCMenuSpecific](#Section_912bf645a367471b9d4efc29583a01bc)* String structure that [**toolbar**](#gt_c57c58f2-a71c-4dc0-ae75-471d52b62f13) customization structures use. This structure specifies a non-null-terminated [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string. [TABLE] **cLen (1 byte):** Unsigned integer that specifies the count of characters in this string. **data (variable):** Array of Unicode characters. The number of characters in the array MUST be equal to the value of the **cLen** field. Because this is a non-null-terminated Unicode string all of the elements of this string MUST NOT have a value of 0x0000. #### SRECT *Referenced by: [TBVisualData](#Section_1b41ab5402664559bc7b92a02483362b)* Specifies a rectangle structure. [TABLE] **left (2 bytes):** Signed integer that specifies the position in pixels of the left side of the rectangle. **top (2 bytes):** Signed integer that specifies the position in pixels of the top side of the rectangle. **right (2 bytes):** Signed integer that specifies the position in pixels of the right side of the rectangle. **bottom (2 bytes):** Signed integer that specifies the position in pixels of the bottom side of the rectangle. #### TB Structure that contains [**toolbar**](#gt_c57c58f2-a71c-4dc0-ae75-471d52b62f13) information. [TABLE] **bSignature (1 byte):** Signed integer that specifies the toolbar signature number. MUST be 0x02. **bVersion (1 byte):** Signed integer that specifies the toolbar version number. MUST be 0x01. **cCL (2 bytes):** Signed integer that SHOULD[\<2\>](#Appendix_A_2) specify the number of [**toolbar controls**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d) contained in this toolbar. **ltbid (4 bytes):** Signed integer that specifies the toolbar ID. MUST be 0x00000001 ([**custom toolbar**](#gt_6ee69c13-ffa9-43b1-989e-a942dceb1fa5) ID). **ltbtr (4 bytes):** Unsigned integer of type [**TBTRFlags**](#Section_e51860d90eb74d6b8608a6eaf078dd53) (section 2.3.1.7) that specifies the toolbar type and toolbar restrictions. **cRowsDefault (2 bytes):** Unsigned integer that specifies the number of preferred rows for the toolbar when the toolbar is not [**docked**](#gt_96e46041-1a76-4cbf-a612-d918840976be). MUST be less than or equal to 255. **bFlags (2 bytes):** Unsigned integer of type [**TBFlags**](#Section_2809bc150e0d4c959444e624aa9b76ec) (section 2.3.1.8). **name (variable):** Structure of type [**WString**](#Section_9aa198843ab34da3a4aff2db446befda) (section 2.3.1.4) that specifies the toolbar name. #### TBTRFlags *Referenced by: [TB](#Section_4b59413771ec456fbaf9ba1dd0a28c5c)* [**Toolbar**](#gt_c57c58f2-a71c-4dc0-ae75-471d52b62f13) type and restrictions flags. The bit description begins from the least significant bit. This structure MUST specify the toolbar type which means that the 8 most significant bits MUST have one of the values in the following table. | 8 most significant bits of the TBTRFlags structure (section 2.3.1.7) | Meaning | |----|----| | 00000000 | Specifies that the toolbar is a [**basic toolbar**](#gt_39d82905-44bc-438d-9b2d-a2cd633a9dd9). | | 00000010 | Specifies that the toolbar is a [**menu toolbar**](#gt_2eb45441-112f-420b-ab4a-768b569582dc). | The rest of the bits in this structure specify toolbar restrictions. A toolbar restriction limits the end user’s ability to change and manipulate the toolbar. [TABLE] **A - NoAddDelCtl (1 bit):** A bit that specifies whether [**toolbar controls**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d) can be added to or removed from this toolbar. A value of 1 specifies that no toolbar controls can be added or removed from this toolbar. **B - NoResize (1 bit):** A bit that specifies whether this toolbar can be resized when not [**docked**](#gt_96e46041-1a76-4cbf-a612-d918840976be). A value of 1 specifies that this toolbar cannot be resized when not docked. **C - NoMove (1 bit):** A bit that specifies whether this toolbar can or cannot be moved. A value of 1 specifies that this toolbar cannot be moved. **D - NoChangeVisible (1 bit):** A bit that specifies whether the visibility of this toolbar can be changed. A value of 1 specifies that the visibility of this toolbar cannot be changed. **E - NoChangeDock (1 bit):** A bit that specifies whether the [**docked location**](#gt_fd188728-2b59-4fd1-aec1-ac2a60c3d567) of this toolbar can or cannot be changed. A value of 1 specifies that the end user cannot change the docked location of this toolbar. **F - NoVerticalDock (1 bit):** A bit that specifies whether this toolbar can be vertically docked. A value of 1 specifies that the toolbar cannot be vertically docked. **G - NoHorizontalDock (1 bit):** A bit that specifies whether this toolbar can be horizontally docked. A value of 1 specifies that the toolbar cannot be horizontally docked. **H - NoBorder (1 bit):** A bit that specifies whether the toolbar has a title bar and a border when not docked. A value of 1 specifies that the toolbar does not have a title bar and a border when not docked. MUST be 1 when the **TBTPopupMenu** field equals 1; MUST be 0 when the **TBTPopupMenu** equals 0. **I - NoTbContextMenu (1 bit):** A bit that specifies whether the toolbar shows a [**context menu**](#gt_df0390ab-3a38-4d1c-a74f-1dcfaf7464fc) when right-clicked. A value of 1 specifies that the toolbar will not show a context menu when right-clicked. MUST be 1 when **TBTPopupMenu** equals 1; MUST be 0 when **TBTPopupMenu** equals 0. **J - reserved1 (1 bit):** Reserved bit. MUST be 0. **K - reserved2 (1 bit):** Reserved bit. MUST be 0. **L - NotTopLevel (1 bit):** A bit that specifies whether the toolbar can be a [**top-level toolbar**](#gt_9cf4e9c6-38c4-422c-8190-7ddf53ed9151). A value of 1 specifies that this toolbar is a child of another toolbar, and can never be a top-level toolbar. A value of 0 specifies that this toolbar can be a top-level toolbar. MUST be 1 when the **TBTPopupMenu** field equals 1; MUST be 0 when the **TBTPopupMenu** field equals 0. **M - reserved3 (1 bit):** Reserved bit. MUST be 0. **N - reserved4 (1 bit):** Reserved bit. MUST be 0. **O - reserved5 (1 bit):** Reserved bit. MUST be 0. **P - reserved6 (1 bit):** Reserved bit. MUST be 0. **Q - reserved7 (1 bit):** Reserved bit. MUST be 0. **R - reserved8 (1 bit):** Reserved bit. MUST be 0. **S - reserved9 (1 bit):** Reserved bit. MUST be 0. **T - reserved10 (1 bit):** Reserved bit. MUST be 0. **U - reserved11 (1 bit):** Reserved bit. MUST be 0. **V - reserved12 (1 bit):** Reserved bit. MUST be 0. **W - reserved13 (1 bit):** Reserved bit. MUST be 0. **X - reserved14 (1 bit):** Reserved bit. MUST be 0. **Y - reserved15 (1 bit):** Reserved bit. MUST be 0. **Z - TBTPopupMenu (1 bit):** A bit that specifies whether this toolbar is of type menu toolbar. A value of 1 specifies that this is a menu toolbar. If the value equals 1, the fields **NoResize**, **NoMove**, **NoChangeDock**, **NoBorder**, **NoTbContextMenu**, and **NotTopLevel** MUST equal 1. **a - reserved16 (1 bit):** Reserved bit. MUST be 0. **reserved17 (5 bits):** Reserved bits. MUST be 0. #### TBFlags *Referenced by: [TB](#Section_4b59413771ec456fbaf9ba1dd0a28c5c)* [**Toolbar**](#gt_c57c58f2-a71c-4dc0-ae75-471d52b62f13) flags. The bit description begins from the least significant bit. [TABLE] **A - fDisabled (1 bit):** A bit that specifies whether this toolbar is disabled. A value of 1 specifies that this toolbar is disabled. **B - reserved1 (1 bit):** Undefined and MUST be ignored. **C - fCtlModified (1 bit):** A bit that specifies whether the [**toolbar controls**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d) of this toolbar have to be saved to the file. A value of 1 specifies that the toolbar controls of this toolbar have to be saved to the file. MAY be 0 and the toolbar MAY still save its toolbar controls to the file.[\<3\>](#Appendix_A_3) **D - fNoAdaptiveMenus (1 bit):** A bit that specifies whether [**adaptive menus**](#gt_6e6d597e-b4ee-4c54-991e-88ced9e12a9c) are disabled for this toolbar. A value of 1 specifies that adaptive menus are disabled for this toolbar. **E - fNeedsPositioning (1 bit):** A bit that specifies whether the toolbar’s non-[**docked**](#gt_96e46041-1a76-4cbf-a612-d918840976be) position needs to be updated for display on multiple monitors. A value of 1 specifies that the toolbar's non-docked position needs to be updated for display on multiple monitors. **reserved2 (11 bits):** Reserved bits. MUST be 0. #### TBVisualData Contains visual information about a [**toolbar**](#gt_c57c58f2-a71c-4dc0-ae75-471d52b62f13). The values of some of the fields in this structure are restricted by the toolbar type and restrictions of this toolbar (the value of the **ltbtr** field of the [**TB**](#Section_4b59413771ec456fbaf9ba1dd0a28c5c) structure (section 2.3.1.6) that contains the structure that contains this structure). The restrictions are shown in the following table. [TABLE] [TABLE] **tbds (1 byte):** Signed integer that specifies the current toolbar [**docked**](#gt_96e46041-1a76-4cbf-a612-d918840976be) state. The value MUST be in the following table. | Value | Meaning | |:-----:|-------------------------------------------------------| | 0x00 | Toolbar is docked on application frame at the left. | | 0x01 | Toolbar is docked on application frame at the top. | | 0x02 | Toolbar is docked on application frame at the right. | | 0x03 | Toolbar is docked on application frame at the bottom. | | 0x04 | Toolbar is not docked. | **tbv (1 byte):** Signed integer that specifies the toolbar visibility. The value MUST be in the following table. | Value | Meaning | |:-----:|-------------------------| | 0x00 | Toolbar is not visible. | | 0x01 | Toolbar is visible. | | 0x02 | Toolbar is visible. | **tbdsDock (1 byte):** Signed integer that SHOULD specify the toolbar docked state. The value MUST be in the following table. | Value | Meaning | |:-----:|-------------------------------------------------------| | 0x00 | Toolbar is docked on application frame at the left. | | 0x01 | Toolbar is docked on application frame at the top. | | 0x02 | Toolbar is docked on application frame at the right. | | 0x03 | Toolbar is docked on application frame at the bottom. | If the value of the **tbds** field is less than or equal to 0x03, this value MUST be equal to the value of the **tbds** field. When tbds is greater than 0x03, this field specifies the most recent toolbar dock state. **iRow (1 byte):** Signed integer that specifies, when the toolbar is docked, the index of the [**docked location**](#gt_fd188728-2b59-4fd1-aec1-ac2a60c3d567) of the toolbar in the [**docking area**](#gt_25929137-cc77-41d9-af22-d3f449b23dcf) in relation to other toolbars in the docking area. MUST be in the range 0-127 or in the following table. | Value | Meaning | |----|----| | 0xFE (-2) | Row append. Toolbar is placed on the last row of the docking area. | | 0xFD (-3) | Row prepend. Toolbar is placed on the first row of the docking area. | **rcDock (8 bytes):** Structure of type [**SRECT**](#Section_21c05acf851f4874bdcbd69e94bffed1) (section 2.3.1.5) that specifies the preferred docked location of the toolbar. Refer to the following table for the meaning of the values of each field of this structure. | Field of rcDock structure | Meaning | |----|----| | **rcDock.left** | Signed integer that specifies the distance in pixels from the left border of the docking area to the left border of the toolbar. | | **rcDock.top** | Signed integer that specifies the distance in pixels from the top border of the docking area to the top border of the toolbar. | | **rcDock.right** | Signed integer that specifies the distance in pixels from the left border of the docking area to the right border of the toolbar. | | **rcDock.bottom** | Signed integer that specifies the distance in pixels from the top border of the docking area to the bottom border of the toolbar. | **rcFloat (8 bytes):** Structure of type **SRECT** (section 2.3.1.5) that specifies the preferred toolbar location when the toolbar is not docked. Refer to the following table for the meaning of the values of each field of this structure. | Field of rcFloat structure | Meaning | |----|----| | **rcFloat.left** | Signed integer that specifies the distance in pixels from the left border of the screen to the left border of the toolbar. | | **rcFloat.top** | Signed integer that specifies the distance in pixels from the top border of the screen to the top border of the toolbar. | | **rcFloat.right** | Signed integer that specifies the distance in pixels from the left border of the screen to the right border of the toolbar. | | **rdFloat.bottom** | Signed integer that specifies the distance in pixels from the top border of the screen to the bottom border of the toolbar. | #### TBCHeader [**Toolbar control**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d) header information. [TABLE] **bSignature (1 byte):** Signed integer that specifies the toolbar control signature number. MUST be 0x03. **bVersion (1 byte):** Signed integer that specifies the toolbar control version number. MUST be 0x01. **bFlagsTCR (1 byte):** Structure of type [**TBCFlags**](#Section_8b35e28b45f14e92ab1a39fa84e0fb2b) (section 2.3.1.11) that specifies toolbar control flags. **tct (1 byte):** Unsigned integer that specifies the [**toolbar control type**](#gt_6a54dff3-f66e-4140-9b4d-30643e7e428f). The value MUST be in the following table: | Value | Toolbar control type | |----|----| | 0x01 | Button control | | 0x02 | Edit control | | 0x03 | DropDown control | | 0x04 | ComboBox control | | 0x06 | [**SplitDropDown control**](#gt_809470f7-7486-4a44-a50d-2489b32389af) | | 0x07 | [**OCXDropDown control**](#gt_e139011b-a966-4495-9264-d923ecdfeb66) | | 0x09 | [**GraphicDropDown control**](#gt_007e8308-eee4-4435-a1f8-e2b27e58f1ac) | | 0x0A | [**Popup control**](#gt_a259e677-3d9d-47e4-87ba-590fd09734c8) | | 0x0C | [**ButtonPopup control**](#gt_d638405a-d78b-4c5f-aed2-8616d98d3519) | | 0x0D | [**SplitButtonPopup control**](#gt_1c046ab6-2530-4a41-8d19-03f92914beaf) | | 0x0E | [**SplitButtonMRUPopup control**](#gt_01b548cd-095a-4517-a468-1771a038c392) | | 0x0F | Label control | | 0x10 | [**ExpandingGrid control**](#gt_b419469c-ed58-4e45-af81-21dd840c8770) | | 0x12 | [**Grid control**](#gt_3ffa7c43-7cdc-480a-ac6c-f3a624a1bb38) | | 0x13 | [**Gauge control**](#gt_52882546-dd96-4cff-8bbb-ae3e7d7a0b4c) | | 0x14 | [**GraphicCombo control**](#gt_b724d1c9-9cf9-4b1f-82fb-a6a1a20748a5) | | 0x15 | [**Pane control**](#gt_0b77cb34-c2be-4fbe-8f82-df82f7b02b07) | | 0x16 | [**ActiveX control**](#gt_f3dcc35f-8f80-474e-ac39-106a23f059c2) | **tcid (2 bytes):** Unsigned integer that specifies the [**toolbar control identifier (TCID)**](#gt_28d9adbd-b340-469a-97cd-3befd6a782b3) for this toolbar control. MUST be 0x0001 when the toolbar control is a [**custom toolbar control**](#gt_75556eac-bd5a-4dc2-b7b5-48c27bfa1c93) or MUST be equal to one of the values listed in [\[MS-CTDOC\]](%5bMS-CTDOC%5d.pdf#Section_aff21c961b434bcf8c8a677e012c7e6a) section 2.2 or in [\[MS-CTXLS\]](%5bMS-CTXLS%5d.pdf#Section_b461dcd9933e471081bcdc1c74801b6b) section 2.2 when the toolbar control is not a custom toolbar control. **tbct (4 bytes):** Structure of type [**TBCSFlags**](#Section_df3f6f9b34c6451fad13765c2cb63c09) (section 2.3.1.12) that specifies toolbar control flags. **bPriority (1 byte):** Unsigned integer that specifies the toolbar control priority for dropping and wrapping purposes. The value MUST be in the range 0x00 to 0x07. If the value equals 0x00, it is considered the default state. If it equals 0x01 the toolbar control will never be dropped from the [**toolbar**](#gt_c57c58f2-a71c-4dc0-ae75-471d52b62f13) and will be wrapped when needed. Otherwise, the higher the number the sooner the toolbar control will be dropped. **width (2 bytes):** Unsigned integer that specifies the width, in pixels, of the toolbar control. MUST only exist if **bFlagsTCR.fSaveDxy** equals 1. **height (2 bytes):** Unsigned integer that specifies the height, in pixels, of the toolbar control. MUST only exist if **bFlagsTCR.fSaveDxy** equals 1. #### TBCFlags *Referenced by: [TBCHeader](#Section_6fec0363d40148aaacdf46b7a8bf31db)* [**Toolbar control**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d) flags. The bit description begins from the least significant bit. | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | |-----|-----|-----|-----|-----|-----|-----|-----| | A | B | C | D | E | F | G | H | **A - fHidden (1 bit):** A bit that specifies whether this toolbar control is visible. A value of 1 specifies that the toolbar control is not visible. **B - fBeginGroup (1 bit):** A bit that specifies whether a [**toolbar control separator**](#gt_babca65d-f3a3-4f29-b844-fcec439a0964) appears before this toolbar control. A value of 1 specifies that a toolbar control separator appears before the toolbar control. **C - fOwnLine (1 bit):** A bit that specifies whether the toolbar control requires its own row. A value of 1 specifies that the toolbar control requires its own row in the [**toolbar**](#gt_c57c58f2-a71c-4dc0-ae75-471d52b62f13). **D - fNoCustomize (1 bit):** A bit that specifies whether this toolbar control can be altered by customization. A value of 1 specifies that the toolbar control cannot be altered by customization. **E - fSaveDxy (1 bit):** A bit that specifies whether the width and height of the toolbar control have been saved to the file. A value of 1 specifies that the **width** and **height** fields of the **TBCHeader** structure (section 2.3.1.10) that contains this structure MUST exist. **F - reserved1 (1 bit):** Reserved bit. Undefined and MUST be ignored. **G - fBeginLine (1 bit):** A bit that specifies whether the toolbar control begins a new row in the toolbar. A value of 1 specifies that the toolbar control begins a new row in the toolbar. **H - reserved2 (1 bit):** Reserved bit. MUST be 0. #### TBCSFlags *Referenced by: [TBCHeader](#Section_6fec0363d40148aaacdf46b7a8bf31db)* [**Toolbar control**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d) flags that manage specific properties of a toolbar control. The bit description begins from the least significant bit. [TABLE] **A - textIcon (2 bits):** Unsigned integer that specifies the visibility of the label and icon of this toolbar control. The value MUST be in the following table: [TABLE] **B - fOwnerDraw (1 bit):** A bit that specifies whether this toolbar control uses an internal rendering option. A value of 1 specifies that this toolbar control uses an internal rendering option. MUST be 0 if the **tcid** value of the **TBCHeader** structure (section 2.3.1.10) that contains this structure equals 0x0001. If the **tcid** value of the **TBCHeader** structure that contains this structure does not equal 0x0001, this value MUST be equal to the value associated with the **tcid** listed in [\[MS-CTDOC\]](%5bMS-CTDOC%5d.pdf#Section_aff21c961b434bcf8c8a677e012c7e6a) section 2.2 or in [\[MS-CTXLS\]](%5bMS-CTXLS%5d.pdf#Section_b461dcd9933e471081bcdc1c74801b6b) section 2.2. **C - fAllowResize (1 bit):** A bit that specifies whether sizing is allowed for this toolbar control. A value of 1 specifies that toolbar control sizing is allowed. This flag is used when a toolbar control is being initialized and allows for the toolbar control to be smaller or bigger than normal. MUST be 0 if the **tcid** value of the **TBCHeader** structure that contains this structure equals 0x0001. If the **tcid** value of the **TBCHeader** structure that contains this structure does not equal 0x0001, this value MUST be equal to the value associated with the **tcid** listed in \[MS-CTDOC\] section 2.2 or in \[MS-CTXLS\] section 2.2. **D - fOneState (1 bit):** A bit that specifies whether this is a one-state toolbar control. This bit is only used by toolbar controls of type Button or ExpandingGrid. A value of 1 specifies that the toolbar control can have only one state (ButtonUp, the value of the **state** field of the [**TBCBSFlags**](#Section_d6b3333d6f7042848b41752d3ede4116) structure (section 2.3.1.18) contained in the [**TBCBSpecific**](#Section_6f6f5f9fe2f04f0d9d6fb15395b364c0) structure (section 2.3.1.17) contained in the [**TBCData**](#Section_2abc9423fd1b49c490986846ddc07283) structure (section 2.3.1.13) that contains toolbar control information for this toolbar control equals 0). MUST be 0 if the **tcid** value of the **TBCHeader** structure that contains this structure equals 0x0001. If the **tcid** value of the **TBCHeader** structure that contains this structure does not equal 0x0001, this value MUST be equal to the value associated with the **tcid** listed in \[MS-CTDOC\] section 2.2 or in \[MS-CTXLS\] section 2.2. **E - fNoSetCursor (1 bit):** A bit that specifies whether the toolbar control can change the mouse cursor when it is over the toolbar control area. A value of 1 specifies that the toolbar control can change the mouse cursor when this is over the toolbar control area. MUST be 0 if the **tcid** value of the **TBCHeader** structure that contains this structure equals 0x0001. SHOULD[\<4\>](#Appendix_A_4) be 0 if the **tcid** value of the **TBCHeader** structure that contains this structure does not equal 0x0001. **F - fNoAccel (1 bit):** A bit that specifies whether this toolbar control has [**accelerator keys**](#gt_d61b4a07-b6c1-4c08-9ebd-1d00b360f953). A value of 1 specifies that the toolbar control does not have accelerator keys. MUST be 0 if the **tcid** value of the **TBCHeader** structure that contains this structure equals 0x0001. SHOULD[\<5\>](#Appendix_A_5) be 0 if the **tcid** value of the **TBCHeader** structure that contains this structure does not equal 0x0001. **G - fChgAccel (1 bit):** A bit that specifies whether the accelerator keys for the toolbar control can change. A value of 1 specifies that the accelerator keys can be changed by the application. MUST be 0 if the **tcid** value of the **TBCHeader** structure that contains this structure equals 0x0001. If the **tcid** value of the **TBCHeader** structure that contains this structure does not equal 0x0001, this value MUST be equal to the value associated with the **tcid** listed in \[MS-CTDOC\] section 2.2 or in \[MS-CTXLS\] section 2.2. **unused1 (8 bits):** Undefined and MUST be ignored. **H - fAlwaysEnabled (1 bit):** A bit that specifies whether this toolbar control is enabled by default. A value of 1 specifies that the toolbar control is enabled by default. MUST be 0 if the **tcid** value of the **TBCHeader** structure that contains this structure equals 0x0001. SHOULD[\<6\>](#Appendix_A_6) be 0 if the **tcid** value of the **TBCHeader** structure that contains this structure does not equal 0x0001. **I - fAlwaysVisible (1 bit):** A bit that specifies whether this toolbar control is visible by default. A value of 1 specifies that the toolbar control is visible by default. MUST be 0 if the **tcid** value of the **TBCHeader** structure that contains this structure equals 0x0001. If the **tcid** value of the **TBCHeader** structure that contains this structure does not equal 0x0001, this value MUST be equal to the value associated with the **tcid** listed in \[MS-CTDOC\] section 2.2 or in \[MS-CTXLS\] section 2.2. **J - fNoChangeLabel (1 bit):** A bit that specifies whether the label of the toolbar control can change. A value of 1 specifies that the toolbar control label does not be changed by the application. MUST be 0 if the **tcid** value of the **TBCHeader** structure (section 2.3.1.10) that contains this structure equals 0x0001. If the **tcid** value of the **TBCHeader** structure that contains this structure does not equal 0x0001, this value MUST be equal to the value associated with the **tcid** listed in \[MS-CTDOC\] section 2.2 or in \[MS-CTXLS\] section 2.2. **K - fKeepLabel (1 bit):** A bit that specifies whether the label of the toolbar control can change. A value of 1 specifies that the toolbar control label will not be changed by the application unless the toolbar control is reset. **L - fNoQueryTooltip (1 bit):** A bit that specifies whether the toolbar control can use an internal string as a [**ToolTip**](#gt_84d44447-feaf-41a4-bf12-004c0f080fc2). A value of 1 specifies that the toolbar control will not use an internal string as a ToolTip. If the toolbar control has a custom ToolTip, it will use it. MUST be 0 if the **tcid** value of the **TBCHeader** structure (section 2.3.1.10) that contains this structure equals 0x0001. If the **tcid** value of the **TBCHeader** structure that contains this structure does not equal 0x0001, this value MUST be equal to the value associated with the **tcid** listed in \[MS-CTDOC\] section 2.2 or in \[MS-CTXLS\] section 2.2. **M - fSaveUIStrings (1 bit):** A bit that specifies whether none, one, or more of a variety of strings are saved to the file. A value of 1 specifies that one or more of the following fields will be saved to the file: **customText**, **descriptionText**, and **tooltip** fields of the [**TBCGeneralInfo**](#Section_99109267262941139ceca9481d6d606d) structure (section 2.3.1.14) contained by the **TBCData** structure (section 2.3.1.13) contained by the structure that contains the **TBCHeader** structure (section 2.3.1.10) that contains this structure and if this toolbar control is of type Button or ExpandingGrid, the **wstrAcc** field of the **TBCBSpecific** structure (section 2.3.1.17) contained by the **TBCData** structure contained by the structure that contains the **TBCHeader** structure that contains this structure. When the value of the **tcid** field of the **TBCHeader** structure that contains the **TBCSFlags** structure (section 2.3.1.12) that contains this field equals 1, **fSaveUIStrings** is equal to 1, even if no extra strings are saved to the file. **N - fExclusivePopup (1 bit):** A bit that specifies whether the toolbar control is going to drop a unique [**custom toolbar**](#gt_6ee69c13-ffa9-43b1-989e-a942dceb1fa5). This bit is only used by toolbar controls that drop a [**menu toolbar**](#gt_2eb45441-112f-420b-ab4a-768b569582dc). A value of 1 specifies that the toolbar control is going to drop a unique custom toolbar. SHOULD[\<7\>](#Appendix_A_7) be 0. **O - fDefaultBehavior (1 bit):** A bit that specifies whether the toolbar control will have default behavior during [**OLE**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) merging. A value of 1 specifies that the toolbar control will have default behavior during OLE merging. A value of 0 specifies that the application can change the behavior of the toolbar control during OLE merging. SHOULD[\<8\>](#Appendix_A_8) be 0. **P - unused2 (1 bit):** Undefined and MUST be ignored. **Q - fWrapText (1 bit):** A bit that specifies whether the toolbar control can wrap its label across multiple lines. A value of 1 specifies that the label of the toolbar control can wrap across multiple lines. **R - fTextBelow (1 bit):** A bit that specifies that the label of the toolbar control will be displayed under the toolbar control icon. A value of 1 specifies that the label of the toolbar control will be displayed under the toolbar control icon, rather than beside it. **unused3 (4 bits):** Undefined and MUST be ignored. **S - reserved1 (1 bit):** Reserved bit. MUST be 0. #### TBCData [**Toolbar control**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d) information. [TABLE] **controlGeneralInfo (variable):** Structure of type [**TBCGeneralInfo**](#Section_99109267262941139ceca9481d6d606d) (section 2.3.1.14) that specifies toolbar control general information. **controlSpecificInfo (variable):** Toolbar control specific information is saved depending on the type of the toolbar control which is specified by the value of the **tct** field of the [TBCHeader](#Section_6fec0363d40148aaacdf46b7a8bf31db) structure (section 2.3.1.10) contained by the structure that contains this structure. The following table shows the type of structure that is saved according to the type of the toolbar control: | Value of the tct field | Type of the controlSpecificInfo field | |----|----| | 0x01 (Button control) | [**TBCBSpecific**](#Section_6f6f5f9fe2f04f0d9d6fb15395b364c0) (section 2.3.1.17) | | 0x10 ([**ExpandingGrid control**](#gt_b419469c-ed58-4e45-af81-21dd840c8770)) | **TBCBSpecific** | | 0x0A ([**Popup control**](#gt_a259e677-3d9d-47e4-87ba-590fd09734c8)) | [**TBCMenuSpecific**](#Section_912bf645a367471b9d4efc29583a01bc) (section 2.3.1.21) | | 0x0C ([**ButtonPopup control**](#gt_d638405a-d78b-4c5f-aed2-8616d98d3519)) | **TBCMenuSpecific** | | 0x0D ([**SplitButtonPopup control**](#gt_1c046ab6-2530-4a41-8d19-03f92914beaf)) | **TBCMenuSpecific** | | 0x0E ([**SplitButtonMRUPopup control**](#gt_01b548cd-095a-4517-a468-1771a038c392)) | **TBCMenuSpecific** | | 0x02 (Edit control) | [**TBCComboDropdownSpecific**](#Section_d264bd1960084eb5ba7ce1e12a80c7a3) (section 2.3.1.19) | | 0x04 (ComboBox control) | **TBCComboDropdownSpecific** | | 0x14 ([**GraphicCombo control**](#gt_b724d1c9-9cf9-4b1f-82fb-a6a1a20748a5)) | **TBCComboDropdownSpecific** | | 0x03 (DropDown control) | **TBCComboDropdownSpecific** | | 0x06 ([**SplitDropDown control**](#gt_809470f7-7486-4a44-a50d-2489b32389af)) | **TBCComboDropdownSpecific** | | 0x09 ([**GraphicDropDown control**](#gt_007e8308-eee4-4435-a1f8-e2b27e58f1ac)) | **TBCComboDropdownSpecific** | | 0x07 ([**OCXDropDown control**](#gt_e139011b-a966-4495-9264-d923ecdfeb66)) | **controlSpecificInfo** MUST NOT exist | | 0x0F (Label control) | **controlSpecificInfo** MUST NOT exist | | 0x12 ([**Grid control**](#gt_3ffa7c43-7cdc-480a-ac6c-f3a624a1bb38)) | **controlSpecificInfo** MUST NOT exist | | 0x13 ([**Gauge control**](#gt_52882546-dd96-4cff-8bbb-ae3e7d7a0b4c)) | **controlSpecificInfo** MUST NOT exist | | 0x15 ([**Pane control**](#gt_0b77cb34-c2be-4fbe-8f82-df82f7b02b07)) | **controlSpecificInfo** MUST NOT exist | | 0x16 ([**ActiveX control**](#gt_f3dcc35f-8f80-474e-ac39-106a23f059c2)) | **controlSpecificInfo** MUST NOT exist | #### TBCGeneralInfo *Referenced by: [TBCData](#Section_2abc9423fd1b49c490986846ddc07283)* [**Toolbar control**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d) general information. [TABLE] **bFlags (1 byte):** Structure of type [**TBCGIFlags**](#Section_5a7caae568844e45b93687022aa2f2d6) (section 2.3.1.15) that specifies which of the fields of this structure have been saved to the file. **customText (variable):** Optional. Structure of type [**WString**](#Section_9aa198843ab34da3a4aff2db446befda) (section 2.3.1.4) that specifies the custom label of the toolbar control. MUST exist if **bFlags.fSaveText** equals 1. MUST NOT exist if **bFlags.fSaveText** equals 0. **descriptionText (variable):** Optional. Structure of type **WString** that specifies a description of this toolbar control. MUST exist if **bFlags.fSaveMiscUIStrings** equals 1. MUST NOT exist if **bflags.fSaveMiscUIString** equals 0. **tooltip (variable):** Optional. Structure of type **WString** that SHOULD specify the [**ToolTip**](#gt_84d44447-feaf-41a4-bf12-004c0f080fc2) of this toolbar control. MUST exist if **bFlags.fSaveMiscUIStrings** equals 1. MUST NOT exist if **bFlags.fSaveMiscUIStrings** equals 0. If the toolbar control is of type Button or ExpandingGrid, and the fHyperlinkType field of the TBCBSFlags structure (section [2.3.1.18](#Section_d6b3333d6f7042848b41752d3ede4116)) contained by the TBCBSpecific structure (section [2.3.1.17](#Section_6f6f5f9fe2f04f0d9d6fb15395b364c0)), contained by the TBCData structure (section 2.3.1.13) that contains the TBCGeneralInfo structure (section 2.3.1.14) that contains this structure does not equal 0, the value of tooltip specifies the hyperlink path for the toolbar control. **extraInfo (variable):** Optional. Structure of type [**TBCExtraInfo**](#Section_feebb647ba9c40378718babc740201c5) (section 2.3.1.16) that specifies extra information saved for a toolbar control. MUST exist if **bFlags.fSaveMiscCustom** equals 1. MUST NOT exist if **bFlags.fSaveMiscCustom** equals 0. #### TBCGIFlags *Referenced by: [TBCGeneralInfo](#Section_99109267262941139ceca9481d6d606d)* [**Toolbar control**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d) general information flags that specify which fields in the **TBCGeneralInfo** structure (section 2.3.1.14) that contains this structure will be saved to the file. The bit description begins from the least significant bit. [TABLE] **A - fSaveText (1 bit):** A bit that specifies whether the toolbar control will save its custom text. A value of 1 specifies that the **customText** field of the **TBCGeneralInfo** structure (section 2.3.1.14) that contains this structure MUST exist. If the value equals 1, the value of the **fSaveUIStrings** field of the [**TBCSFlags**](#Section_df3f6f9b34c6451fad13765c2cb63c09) structure (section 2.3.1.12) contained by the [**TBCHeader**](#Section_6fec0363d40148aaacdf46b7a8bf31db) structure (section 2.3.1.10) contained by the structure that contains the [TBCData](#Section_2abc9423fd1b49c490986846ddc07283) structure (section 2.3.1.13) that contains the **TBCGeneralInfo** structure (section 2.3.1.14) that contains this structure MUST be 1. **B - fSaveMiscUIStrings (1 bit):** A bit that specifies whether the toolbar control will save its description and [**ToolTip**](#gt_84d44447-feaf-41a4-bf12-004c0f080fc2) strings. A value of 1 specifies that the **descriptionText** and **tooltip** fields of the **TBCGeneralInfo** structure that contains this structure MUST exist. If the value equals 1, the value of the **fSaveUIStrings** field of the **TBCSFlags** structure contained by the **TBCHeader** structure contained by the structure that contains the **TBCData** structure that contains the **TBCGeneralInfo** structure that contains this structure MUST be 1. **C - fSaveMiscCustom (1 bit):** A bit that specifies whether the toolbar control will save toolbar control extra information. A value of 1 specifies that the **extraInfo** field of the **TBCGeneralInfo** structure that contains this structure MUST exist. **D - fDisabled (1 bit):** A bit that specifies whether the toolbar control is disabled. A value of 1 specifies that the toolbar control is disabled. **Unused (4 bits):** Undefined and MUST be ignored. #### TBCExtraInfo *Referenced by: [TBCGeneralInfo](#Section_99109267262941139ceca9481d6d606d)* Structure that specifies extra information saved for a [**toolbar control**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d). [TABLE] **wstrHelpFile (variable):** A structure of type [**WString**](#Section_9aa198843ab34da3a4aff2db446befda) (section 2.3.1.4) that specifies the full path to the help file used to provide the help topic of the toolbar control. For this field to be used **idHelpContext** MUST be greater than zero. **idHelpContext (4 bytes):** Signed integer that specifies the help context id number for the help topic of the toolbar control. A help context id is a numeric identifier associated with a specific help topic. For this field to be used **wstrHelpFile** MUST specify a non-empty string. **wstrTag (variable):** Structure of type **WString** that specifies a custom string used to store arbitrary information about the toolbar control. **wstrOnAction (variable):** Structure of type **WString** that specifies the name of the macro associated with this toolbar control. **wstrParam (variable):** Structure of type **WString** that specifies a custom string used to store arbitrary information about the toolbar control. **tbcu (1 byte):** Signed integer that specifies how the toolbar control will be used during [**OLE**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) merging. The value MUST be in the following table. | Value | Meaning | |----|----| | 0xFF | A correct value was not found for this toolbar control. A value of 0x01 will be used when the value of this field is requested. | | 0x00 | Neither. Toolbar control is not applicable when the application is in either OLE host mode or OLE server mode. | | 0x01 | Server. Toolbar control is applicable when the application is in OLE server mode. (This is the default value used by [**custom toolbar controls**](#gt_75556eac-bd5a-4dc2-b7b5-48c27bfa1c93).) | | 0x02 | Host. Toolbar control is applicable when the application is in OLE host mode. | | 0x03 | Both. Toolbar control is applicable when the application is in OLE server mode and OLE host mode. | **tbmg (1 byte):** Signed integer that specifies how the toolbar control will be used during OLE menu merging. This field is only used by toolbar controls of type Popup. The value MUST be in the following table. | Value | Meaning | |----|----| | 0xFF | None. Toolbar control will not be placed in any OLE menu group. | | 0x00 | File. Toolbar control will be placed in the File OLE menu group. | | 0x01 | Edit. Toolbar control will be placed in the Edit OLE menu group. | | 0x02 | Container. Toolbar control will be placed in the Container OLE menu group. | | 0x03 | Object. Toolbar control will be placed in the Object OLE menu group. | | 0x04 | Window. Toolbar control will be placed in the Window OLE menu group. | | 0x05 | Help. Toolbar control will be placed in the Help OLE menu group. | #### TBCBSpecific Contains information specific to button and **ExpandingGrid** type [**toolbar controls**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d). [TABLE] **bFlags (1 byte):** Structure of type [**TBCBSFlags**](#Section_d6b3333d6f7042848b41752d3ede4116) section 2.3.1.18) that specifies which fields of this structure are saved to the file. **icon (variable):** Optional. Structure of type [**TBCBitmap**](#Section_24c6da6cfc9f4815ad189a7a3a6d9205) (section 2.3.1.1) that specifies the icon data for this toolbar control. MUST exist if **bFlags.fCustomBitmap** equals 1. MUST NOT exist if **bFlags.fCustomBitmap** equals 0. **iconMask (variable):** Optional. Structure of type **TBCBitmap** (section 2.3.1.1) that specifies the icon data mask for this toolbar control. MUST exist if **bFlags.fCustomBitmap** equals 1. MUST NOT exist if **bFlags.fCustomBitmap** equals 0. The value of the **biBitCount** field of the [**BITMAPINFOHEADER**](#Section_5eb5fc23797e4e428ef1ef844994d7d4) (section 2.3.1.2) contained by this **TBCBitmap** MUST be 0x01. The **iconMask** is used to specify the transparency of the icon. The **iconMask** is white in all the areas in which the icon is displayed as transparent and is black in all other areas. **iBtnFace (2 bytes):** Optional. Unsigned integer that specifies the icon of the toolbar control. When this value is set, the toolbar control will use the icon of the toolbar control whose [**toolbar control identifier (TCID)**](#gt_28d9adbd-b340-469a-97cd-3befd6a782b3) equals this value. MUST exist if **bFlags.fCustomBtnFace** equals 1. MUST NOT exist if **bFlags.fCustomBtnFace** equals 0. **wstrAcc (variable):** Optional. Structure of type [**WString**](#Section_9aa198843ab34da3a4aff2db446befda) (section 2.3.1.4) that specifies the [**accelerator keys**](#gt_d61b4a07-b6c1-4c08-9ebd-1d00b360f953) for this toolbar control. MUST exist if **bFlags.fAccelerator** equals 1. MUST NOT exist if **bFlags.fAccelerator** equals 0. #### TBCBSFlags *Referenced by: [TBCBSpecific](#Section_6f6f5f9fe2f04f0d9d6fb15395b364c0)* Contains flags for Button and ExpandingGrid type [**toolbar controls**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d). The bit description begins from the least significant bit. [TABLE] **A - state (2 bits):** Unsigned integer that specifies the toolbar control state. The value MUST be in the following table. | Value (value of bits in parenthesis) | Meaning | |--------------------------------------|---------------------------| | 0x00 (00) | Button is up. | | 0x01 (01) | Button is down (pushed). | | 0x03 (11) | Button is in mixed state. | **B - fAccelerator (1 bit):** A bit that specifies whether the **wstrAcc** field of the **TBCBSpecific** structure (section 2.3.1.17) that contains this structure has been saved to the file. A value of 1 specifies that the **wstrAcc** field of the **TBCBSpecific** structure (section 2.3.1.17) that contains this structure MUST exist. If the value equals 1, the value of the **fSaveUIStrings** field of the [**TBCSFlags**](#Section_df3f6f9b34c6451fad13765c2cb63c09) structure (section 2.3.1.12) contained by the [**TBCHeader**](#Section_6fec0363d40148aaacdf46b7a8bf31db) structure (section 2.3.1.10) contained by the structure that contains the [**TBCData**](#Section_2abc9423fd1b49c490986846ddc07283) structure (section 2.3.1.13) that contains the **TBCBSpecific** structure (section 2.3.1.17) that contains this structure MUST be 1. **C - fCustomBitmap (1 bit):** A bit that specifies whether the toolbar control has a custom icon. A value of 1 specifies that the **icon** and **iconMask** fields of the **TBCBSpecific** structure that contains this structure MUST exist. **D - fCustomBtnFace (1 bit):** A bit that specifies whether the toolbar control is using an alternate icon as its own. A value of 1 specifies that the **iBtnFace** field of the **TBCBSpecific** structure that contains this structure MUST exist. **E - fHyperlinkType (2 bits):** Unsigned integer that specifies the type of [**hyperlink**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) associated with this toolbar control. The value MUST be in the following table. | Value (value of bits in parenthesis) | Hyperlink type | |----|----| | 0x00 (00) | No hyperlink. This toolbar control does not have a hyperlink. | | 0x01 (01) | Open in browser. The hyperlink will be opened in the default browser. | | 0x02 (10) | Image link. The hyperlink links to an image file. | **F - reserved1 (1 bit):** Reserved bit. SHOULD[\<9\>](#Appendix_A_9) be 1. #### TBCComboDropdownSpecific Contains information specific to Edit, ComboBox, GraphicCombo, DropDown, SplitDropDown, and GraphicDropDown type [**toolbar controls**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d). [TABLE] **data (variable):** Optional. Structure of type [**TBCCDData**](#Section_aa9aecdd1d154724adecc1f6bd7e8c59) (section 2.3.1.20). MUST exist if the [**toolbar control identifier (TCID)**](#gt_28d9adbd-b340-469a-97cd-3befd6a782b3) (the **tcid** field of the [**TBCHeader**](#Section_6fec0363d40148aaacdf46b7a8bf31db) structure (section 2.3.1.10) contained by the structure that contains the [**TBCData**](#Section_2abc9423fd1b49c490986846ddc07283) structure (section 2.3.1.13) that contains this structure) equals 0x0001. MUST NOT exist if the TCID does not equal 0x0001. #### TBCCDData *Referenced by: [TBCComboDropdownSpecific](#Section_d264bd1960084eb5ba7ce1e12a80c7a3)* Contains information specific to Edit, ComboBox, GraphicCombo, DropDown, SplitDropDown, and GraphicDropDown type [**toolbar controls**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d). [TABLE] **cwstrItems (2 bytes):** Signed integer that specifies the number of items in **wstrList**. MUST be positive. **wstrList (variable):** Zero-based index array of [**WString**](#Section_9aa198843ab34da3a4aff2db446befda) structures (section 2.3.1.4). The number of elements MUST be equal to **cwstrItems**. Contains the list of strings that are dropped by this toolbar control. **cwstrMRU (2 bytes):** Signed integer that specifies the number of most recently used strings. MUST be equal to 0xFFFF (-1) or greater than or equal to 0x0000. A value of 0xFFFF (-1) means that there are no most recently used strings. **iSel (2 bytes):** Signed integer that specifies the zero-based index of the selected item in the **wstrList** field. MUST be equal to 0xFFFF (-1) or greater than or equal to 0x0000. A value of 0xFFFF (-1) means that there is no selected item. MUST be less than the **cwstrItems** value. **cLines (2 bytes):** Signed integer that specifies the suggested number of lines that the toolbar control will display at any time when displaying the elements of **wstrList**. A value of 0x0000 means that the toolbar control will size itself according to the number of items. MUST equal to or greater than 0x0000. **dxWidth (2 bytes):** Signed integer that specifies the width in pixels that the interior of the drop-down has. This excludes the width of the toolbar control border and scroll bar. MUST be equal to 0xFFFF (-1) or greater than or equal to 0x0000. A value of 0xFFFF (-1) will set the width to accommodate all the strings in **wstrList**. **wstrEdit (variable):** Structure of type **WString** (section 2.3.1.4). Editable text for editable area of the ComboBox toolbar control. #### TBCMenuSpecific Contains information specific to **Popup**, **ButtonPopup**, **SplitButtonPopup**, and **SplitButtonMRUPopup** type [**toolbar controls**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d). [TABLE] **tbid (4 bytes):** Signed integer that specifies the [**toolbar**](#gt_c57c58f2-a71c-4dc0-ae75-471d52b62f13) ID of the toolbar that the toolbar control drops. MUST be greater than or equal to 0x00000000. A value of 0x00000000 means that the toolbar control does not drop a toolbar. A value of 0x00000001 means that the toolbar control drops a [**custom toolbar**](#gt_6ee69c13-ffa9-43b1-989e-a942dceb1fa5). A value greater than 0x00000001 means that the toolbar control drops a built-in toolbar. See [\[MS-CTDOC\]](%5bMS-CTDOC%5d.pdf#Section_aff21c961b434bcf8c8a677e012c7e6a) section 2.1 and [\[MS-CTXLS\]](%5bMS-CTXLS%5d.pdf#Section_b461dcd9933e471081bcdc1c74801b6b) section 2.1 for a list of toolbar identifiers associated with built-in toolbars. **name (variable):** Optional. Structure of type [**WString**](#Section_9aa198843ab34da3a4aff2db446befda) (section 2.3.1.4). Name of the custom toolbar that the toolbar control drops. MUST exist if **tbid** equals 0x00000001. MUST NOT exist if **tbid** is not equal to 0x00000001. ### Visual Basic for Applications Digital Signature Storage Specifies the format of the [**digital signature**](#gt_ad0cf6e3-05c3-482d-ab0f-617f91871189) for [**Visual Basic for Applications (VBA)**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) projects. #### DigSigInfoSerialized *Referenced by: [DigSigBlob](#Section_bc21c922b7ae473690aa86afb6403462), [WordSigBlob](#Section_0a2166b32e294b12886dd89f23c6824c)* Specifies the detailed data of a [**VBA**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) [**digital signature**](#gt_ad0cf6e3-05c3-482d-ab0f-617f91871189). [TABLE] **cbSignature (4 bytes):** An unsigned integer that specifies the size of the **pbSignatureBuffer** field in bytes. **signatureOffset (4 bytes):** An unsigned integer that specifies the offset of the **pbSignatureBuffer** field relative to the beginning of this structure’s parent **DigSigBlob** (section 2.3.2.2); or if the parent is a **WordSigBlob** (section 2.3.2.3), the offset is relative to the beginning of the parent’s **cbSigInfo** field. **cbSigningCertStore (4 bytes):** An unsigned integer that specifies the size of the **pbSigningCertStoreBuffer** field in bytes. **certStoreOffset (4 bytes):** An unsigned integer that specifies the offset of the **pbSigningCertStoreBuffer** field relative to the start of this structure’s parent **DigSigBlob** (section 2.3.2.2); or if the parent is a **WordSigBlob** (section 2.3.2.3), the offset is relative to the start of the parent’s **cbSigInfo** field. **cbProjectName (4 bytes):** An unsigned integer that specifies the count in bytes of the **rgchProjectNameBuffer** field, not including the null-terminating character. MUST be 0x00000000. **projectNameOffset (4 bytes):** An unsigned integer that specifies the offset of the **rgchProjectNameBuffer** field relative to the beginning of this structure’s parent **DigSigBlob** (section 2.3.2.2); or if the parent is a **WordSigBlob** (section 2.3.2.3), the offset is relative to the beginning of the parent’s **cbSigInfo** field. **fTimestamp (4 bytes):** This field is reserved and MUST be 0x00000000. MUST ignore on reading. **cbTimestampUrl (4 bytes):** An unsigned integer that specifies the count in bytes of the **rgchTimestampBuffer** field, not including the null-terminating character. MUST be 0x00000000. **timestampUrlOffset (4 bytes):** An unsigned integer that specifies the offset of the **rgchTimestampBuffer** field relative to the beginning of this structure’s parent **DigSigBlob** (section 2.3.2.2); or if the parent is a **WordSigBlob** (section 2.3.2.3), the offset is relative to the beginning of the parent’s **cbSigInfo** field. **pbSignatureBuffer (variable):** An array of bytes that specifies the [**VBA Digital Signature**](#Section_7c4ce2e22a714b028f51b9f0eeed756a) (section 2.3.2.4) of the VBA project. **pbSigningCertStoreBuffer (variable):** A [VBASigSerializedCertStore](#Section_e88d644c80f84016a2c093fc5b110877) structure (section 2.3.2.5.5) containing the public [**digital certificate**](#gt_a1dfa70d-7803-413d-8697-c40021a3f3d0) information of the certificate used to create the digital signature. **rgchProjectNameBuffer (variable):** A null-terminated array of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters. The field is reserved and MUST be a single null Unicode character (0x0000). **rgchTimestampBuffer (variable):** A null-terminated array of Unicode characters. The field is reserved and MUST be a single null Unicode character (0x0000). #### DigSigBlob *Referenced by: [VtDigSigValue](#Section_a7c3987feaa64f8cbc5cf0dd124eb32f)* Specifies the layout of the [**VBA**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) [**digital signature**](#gt_ad0cf6e3-05c3-482d-ab0f-617f91871189) data. [TABLE] **cb (4 bytes):** An unsigned integer that specifies the size of the **signatureInfo** and **padding** fields combined, in bytes. **serializedPointer (4 bytes):** An unsigned integer that specifies the offset of the **signatureInfo** field within this structure. MUST be 0x00000008. **signatureInfo (variable):** A [**DigSigInfoSerialized**](#Section_30a00273dbee422fb488f4b8430ae046) structure (section 2.3.2.1) containing the data for the signature. **padding (variable):** An array of bytes. The size of this array is the number of bytes necessary to pad the size of the **signatureInfo** field to a multiple of 4 bytes. The contents of this field are undefined and MUST be ignored. #### WordSigBlob Specifies the layout of the [**VBA**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) [**digital signature**](#gt_ad0cf6e3-05c3-482d-ab0f-617f91871189) data when it is wrapped as a length-prefixed [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) character string. [TABLE] **cch (2 bytes):** An unsigned integer that specifies half the count of bytes of the remainder of the structure. MUST be the value given by the following formula. cch = (**cbSigInfo** + (**cbSigInfo** mod 2) + 8) / 2 **cbSigInfo (4 bytes):** An unsigned integer that specifies the size of the **signatureInfo** field in bytes. **serializedPointer (4 bytes):** An unsigned integer that specifies the offset of the **signatureInfo** field within this structure relative to the **cbSigInfo** field. MUST be 0x00000008. **signatureInfo (variable):** A [**DigSigInfoSerialized**](#Section_30a00273dbee422fb488f4b8430ae046) structure (section 2.3.2.1) containing the data for the signature. **padding (variable):** An array of bytes. The size of this array is the number of bytes necessary to pad the entire structure’s size to a multiple of 2 bytes. The contents of this field are undefined and MUST be ignored. #### VBA Digital Signature The [**VBA**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) [**digital signature**](#gt_ad0cf6e3-05c3-482d-ab0f-617f91871189) MUST be a PKCS \#7 **SignedData** ([\[PKCS7\]](https://go.microsoft.com/fwlink/?LinkId=510681) section 9.1) structure, constrained as specified in the following sections. The following section uses ASN.1 notation [\[ITUX680\]](https://go.microsoft.com/fwlink/?LinkId=89923) to specify the data format where applicable. ##### SignedData Constraints The **SignedData** structure ([\[PKCS7\]](https://go.microsoft.com/fwlink/?LinkId=510681) section 9.1) specifying the [**digital signature**](#gt_ad0cf6e3-05c3-482d-ab0f-617f91871189) MUST conform to the following constraints: - - - - - ##### The **digestAlgorithms** field MUST contain only one **digestAlgorithmIdentifier** (\[PKCS7\] section 6.3), and that **digestAlgorithmIdentifier** MUST specify the identifier of the algorithm used to create the digest of the signature.[\<10\>](#Appendix_A_10)The **contentInfo** field’s **contentType** MUST be an **Object Identifier** [\[ITUX680\]](https://go.microsoft.com/fwlink/?LinkId=89923) with the value "1.3.6.1.4.1.311.2.1.4". The **content** field of the **contentInfo** of this **SignedData** structure MUST be a [**SpcIndirectDataContent**](#Section_1537695a28f048288b7bd6dab62b8030) structure (section 2.3.2.4.3.1).The **certificates** field MUST contain certificates as specified by \[PKCS7\] section 9.1. This MUST include the signature verification certificate and can contain any intermediate certificates between that end entity and the root, including the root. If the **SignedData** contains a **Countersignature** ([\[PKCS9\]](https://go.microsoft.com/fwlink/?LinkId=510682) section 6.6), the certificates associated with the **Countersignature** also MUST be contained in the **certificates** field.The **crls** field SHOULD be absent. If present, the **crls** field MUST be ignored.The **signerInfos** field MUST contain a single [**SignerInfo**](#Section_05ee163f764f40cf921c400bd104a665) structure (section 2.3.2.4.2) (\[PKCS7\] section 9.2).SignerInfo Constraints The **SignerInfo** in the [**SignedData**](#Section_708462617bc14c3094fe29ebf7f697ff) structure (section 2.3.2.4.1) MUST conform to the following constraints: - - - - - - - - ##### The [**authenticatedAttributes**](#Section_e0c3e0df4ced45339a3014caaf94cd83) (section 2.3.2.4.4) field MUST be present.This field MUST contain the following attributes:A **content-type** attribute with its value set as specified in [\[PKCS7\]](https://go.microsoft.com/fwlink/?LinkId=510681) section 9.2.A **message-digest** attribute with its value set as specified in \[PKCS7\] section 9.2.This field can also contain:One [**SpcStatementType**](#Section_c541e3e43d044cbd82db1b73163427fd) attribute (section 2.3.2.4.4.1), but this attribute MUST be ignored.One [**SpcSpOpusInfo**](#Section_917556324b0d44ca89a99699afbbd268) attribute (section 2.3.2.4.4.2).If the signature has been timestamped, then the [**unauthenticatedAttributes**](#Section_2dca257e8a014526adc2bbc62861f05b) field (section 2.3.2.4.5) MUST be present and MUST contain a single **Countersignature** attribute ([\[PKCS9\]](https://go.microsoft.com/fwlink/?LinkId=510682) section 6.6). If the signature has not been timestamped, the **unauthenticatedAttributes** field MUST be absent.SignedData contentInfo Structures The **contentInfo** field of the [**SignedData**](#Section_708462617bc14c3094fe29ebf7f697ff) structure (section 2.3.2.4.1) MUST be a [**SpcIndirectDataContent**](#Section_1537695a28f048288b7bd6dab62b8030) structure (section 2.3.2.4.3.1) or a **SpcIndirectDataContentV2** structure (section [2.3.2.4.3.2](#Section_b44805870ab848428323961c477da0e6)) formatted as specified in the corresponding section. The type of the **contentInfo** field MUST be specified by the consumer of the [**DigSigBlob**](#Section_bc21c922b7ae473690aa86afb6403462) (section 2.3.2.2) or [**WordSigBlob**](#Section_0a2166b32e294b12886dd89f23c6824c) (section 2.3.2.3) structures. ###### SpcIndirectDataContent This structure specifies data about the [**digital signature**](#gt_ad0cf6e3-05c3-482d-ab0f-617f91871189) and contains the [**hash**](#gt_b7e2b611-0af5-4fec-8af2-3f9ce7bad205) of the data that is to be signed. This structure is specified by the following ASN.1 [\[ITUX680\]](https://go.microsoft.com/fwlink/?LinkId=89923) notation. 133. SpcIndirectDataContent ::= SEQUENCE { data SpcAttributeTypeAndOptionalValue, messageDigest DigestInfo } SpcAttributeTypeAndOptionalValue ::= SEQUENCE { type OBJECT IDENTIFIER, value \[0\] EXPLICIT ANY OPTIONAL } DigestInfo ::= SEQUENCE { digestAlgorithm AlgorithmIdentifier, digest OCTETSTRING } AlgorithmIdentifier ::= SEQUENCE { algorithm OBJECT IDENTIFIER, parameters \[0\] EXPLICIT ANY OPTIONAL } The **SpcIndirectDataContent** structure’s fields MUST be constrained as follows: - - The **data** field MUST be a **SpcAttributeTypeAndOptionalValue** structure.The **messageDigest** field MUST be a **DigestInfo** structure.The **SpcAttributeTypeAndOptionalValue** structure fields MUST be constrained as follows: - - The **type** field MUST be an **Object Identifier** \[ITUX680\] with the value 1.3.6.1.4.1.311.2.1.29.The **value** field SHOULD be set to a zero byte **OCTETSTRING** (\[ITUX680\]. If the field has any data associated with it, the data MUST be ignored.The **DigestInfo** structure’s fields MUST be constrained as follows: - - ###### The **digestAlgorithm** field MUST be an **AlgorithmIdentifier** structure. The **algorithm** field of **digestAlgorithm** specifies the **Object Identifier** \[ITUX680\] of the digest algorithm that was used to hash the [**VBA**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) project contents, producing the value for the **digest** field. This **Object Identifier** \[ITUX680\] value MUST be set to the same algorithm identifier as specified in the **digestAlgorithm** field of the [**SignedData**](#Section_708462617bc14c3094fe29ebf7f697ff) structure (section 2.3.2.4.1). The **parameters** field of **digestAlgorithm** MUST be set to the **Null** type \[ITUX680\] with a length of zero.The **digest** field MUST be an **OCTETSTRING** \[ITUX680\]. The value of the **OCTETSTRING** MUST be produced by means of the hash algorithm specified in [\[MS-OVBA\]](%5bMS-OVBA%5d.pdf#Section_575462babf6741909facc275523c75fc) section 2.4.2.SpcIndirectDataContentV2 This structure specifies data about the [**digital signature**](#gt_ad0cf6e3-05c3-482d-ab0f-617f91871189) and contains the [**hash**](#gt_b7e2b611-0af5-4fec-8af2-3f9ce7bad205) of the data that is to be signed. This structure is specified by the following ASN.1 [\[ITUX680\]](https://go.microsoft.com/fwlink/?LinkId=89923) notation. 152. SpcIndirectDataContentV2 ::= SEQUENCE { data SpcAttributeTypeAndOptionalValue, messageDigest DigestInfo } SpcAttributeTypeAndOptionalValue ::= SEQUENCE { type OBJECT IDENTIFIER, value \[0\] EXPLICIT ANY OPTIONAL } DigestInfo ::= SEQUENCE { digestAlgorithm AlgorithmIdentifier, digest OCTETSTRING } AlgorithmIdentifier ::= SEQUENCE { algorithm OBJECT IDENTIFIER, parameters \[0\] EXPLICIT ANY OPTIONAL } SigFormatDescriptorV1 ::= SEQUENCE { size INTEGER, version INTEGER, format INTEGER } SigDataV1Serialized ::= SEQUENCE { algorithmIdSize INTEGER, compiledHashSize INTEGER, sourceHashSize INTEGER, algorithmIdOffset INTEGER, compiledHashOffset INTEGER, sourceHashOffset INTEGER, algorithmId OBJECT IDENTIFIER, compiledHash sourceHash **OCTETSTRING** } The fields of the **SpcIndirectDataContentV2** structure MUST be constrained as follows: - - The **data** field MUST be a **SpcAttributeTypeAndOptionalValue** structure.The **messageDigest** field MUST be a **DigestInfo** structure.The **SpcAttributeTypeAndOptionalValue** structure fields MUST be constrained as follows: - - The **type** field MUST be an **Object Identifier** \[ITUX680\] with the value 1.3.6.1.4.1.311.2.1.31.The **value** field MUST be an **OCTETSTRING** \[ITUX680\]. The value MUST contain the DER encoding ASN.1 data of a **SigFormatDescriptorV1** structure.The **SigFormatDescriptorV1** structure fields MUST be constrained as follows: - - - The **size** field MUST be an **INTEGER** \[ITUX680\] and the value MUST be equal to the size of the structure.The **version** field MUST be an **INTEGER** \[ITUX680\] and the value MUST be equal to 1.The **format** field MUST be an **INTEGER** \[ITUX680\] and the value MUST be equal to 1.The **DigestInfo** structure’s fields MUST be constrained as follows: - - The **digestAlgorithm** field MUST be an **AlgorithmIdentifier** structure. The **algorithm** field of **digestAlgorithm** specifies the **Object Identifier** \[ITUX680\] of the digest algorithm that was used to hash the [**VBA**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) project contents, producing the value for the **digest** field. This **Object Identifier** \[ITUX680\] value MUST be set to the same algorithm identifier as specified in the **digestAlgorithm** field of the [**SignedData**](#Section_708462617bc14c3094fe29ebf7f697ff) structure (section 2.3.2.4.1). The **parameters** field of **digestAlgorithm** MUST be set to the **Null** type \[ITUX680\] with a length of zero.The **digest** field MUST be an **OCTETSTRING** \[ITUX680\]. The value MUST contain the DER encoding ASN.1 data of a **SigDataV1Serialized** structure.The **SigDataV1Serialized** structure fields MUST be constrained as follows: - - - - - - - - - ##### The **algorithmIdSize** field MUST be an **INTEGER** \[ITUX680\] and the value MUST be equal to the size of the **algorithmId** field.The **compiledHashSize** field SHOULD be zero.The **sourceHashSize** field MUST be an **INTEGER** \[ITUX680\] and the value MUST be equal to the size of the **sourceHash** field.The **algorithmIdOffset** field MUST be an **INTEGER** \[ITUX680\] and the value MUST be equal to the position in bytes of the **algorithmId** field from the beginning of the structure.The **compiledHashOffset** field SHOULD be zero.The **sourceHashOffset** field MUST be an **INTEGER** \[ITUX680\] and the value MUST be equal to the position in bytes of the **sourceHash** field from the beginning of the structure.The **algorithmId** field specifies the **Object Identifier** \[ITUX680\] of the digest algorithm that was used to hash the VBA project contents, producing the value for the **digest** field. This **Object Identifier** \[ITUX680\] value MUST be set to the same algorithm identifier as specified in the **digestAlgorithm** field of the **SignedData** structure.The **compiledHash** field SHOULD be empty.The **sourceHash** field MUST be an **OCTETSTRING** \[ITUX680\]. The value of the **OCTETSTRING** MUST be produced by means of the hash algorithm specified in [\[MS-OVBA\]](%5bMS-OVBA%5d.pdf#Section_575462babf6741909facc275523c75fc) section 2.4.2.SignerInfo authenticatedAttributes Structures This section specifies the attribute data that is stored in the **authenticatedAttributes** field of the [**SignerInfo**](#Section_05ee163f764f40cf921c400bd104a665) structure (section 2.3.2.4.2). ###### SpcStatementType This structure is specified by the following ASN.1 [\[ITUX680\]](https://go.microsoft.com/fwlink/?LinkId=89923) notation. 190. SpcStatementType ::= SEQUENCE of OBJECT IDENTIFIER The **SpcStatementType** MUST contain one **Object Identifier** \[ITUX680\] with either the value 1.3.6.1.4.1.311.2.1.21 or 1.3.6.1.4.1.311.2.1.22. The **SpcStatementType** MUST be ignored. ###### SpcSpOpusInfo This structure is specified by the following ASN.1 [\[ITUX680\]](https://go.microsoft.com/fwlink/?LinkId=89923) notation. 191. SpcSpOpusInfo ::= SEQUENCE { programName \[0\] EXPLICIT SpcString OPTIONAL, moreInfo \[1\] EXPLICIT SpcLink OPTIONAL } The **programName** field MUST be set to a [**SpcString**](#Section_d5bcc38d051f47758c4474d52e301702) structure (section 2.3.2.4.4.3). The value of the string contained in this structure specifies the description of the project for which the signature was created. The **unicode** field within the **SpcString** **programName** SHOULD have a value that is a 0 length **BMPSTRING** \[ITUX680\]. A value other than an empty string MAY[\<11\>](#Appendix_A_11) be provided. The **moreInfo** field MUST be set to a [**SpcLink**](#Section_7cb90c30902f48d7a5ee686ce1ff0d36) structure (section 2.3.2.4.4.4) if present. If present the value of the **url** field within the **SpcLink** structure specifies a [**Uniform Resource Locator (URL)**](#gt_433a4fb7-ef84-46b0-ab65-905f5e3a80b1) to associate with the signature.[\<12\>](#Appendix_A_12) ###### SpcString This structure is specified by the following ASN.1 [\[ITUX680\]](https://go.microsoft.com/fwlink/?LinkId=89923) notation. 195. SpcString ::= CHOICE { unicode \[0\] IMPLICIT BMPSTRING } The **unicode** field MUST be of the **BMPSTRING** \[ITUX680\] type. ###### SpcLink This structure is specified by the following ASN.1 \[ITUX680\] notation. 198. SpcLink ::= CHOICE { url \[0\] IMPLICIT IA5STRING } The **url** field MUST be of the **IA5STRING** \[ITUX680\] type. The structure specifies a [**hyperlink**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) resource by using the [**Uniform Resource Locator (URL)**](#gt_433a4fb7-ef84-46b0-ab65-905f5e3a80b1). ##### SignerInfo unauthenticatedAttributes A **Countersignature** located in the [**SignerInfo**](#Section_05ee163f764f40cf921c400bd104a665) (section 2.3.2.4.2) **unauthenticatedAttributes** field SHOULD be generated by a trusted third-party [**time stamp authority**](#gt_3247e47d-5652-471c-8c7a-58e90420a0d8) (TSA). Its purpose is to assert that the [**VBA**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) project signature existed prior to the time specified in the **SigningTime** attribute, specified in the following attributes. The **Countersignature** used MUST consist of the following attributes in the **unauthenticatedAttributes** field: - - - **ContentType** ([\[PKCS9\]](https://go.microsoft.com/fwlink/?LinkId=510682) section 6.3): The attribute’s value MUST be set to PKCS \#7 **Data** ([\[PKCS7\]](https://go.microsoft.com/fwlink/?LinkId=510681) section 8).**SigningTime** (\[PKCS9\] section 6.5): The value MUST be set as specified by \[PKCS9\] section 6.5.**messageDigest** (\[PKCS9\] section 6.4): The value MUST be set as specified by \[PKCS9\] section 6.6.In addition, the certificate ([\[RFC3280\]](https://go.microsoft.com/fwlink/?LinkId=90414)) whose private key signed the **Countersignature** MUST be added to the [**SignedData**](#Section_708462617bc14c3094fe29ebf7f697ff) (section 2.3.2.4.1) **certificates** field. Intermediate and root certificates of the certificate chain, including the signing certificate, MAY also be added to the **SignedData** (section 2.3.2.4.1) **certificates** field. ##### VBA Digital Signature Verification The [**VBA**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) signature verification employs the steps specified in the following sections. The [**SignedData**](#Section_708462617bc14c3094fe29ebf7f697ff) (section [2.3.2.4](#Section_7c4ce2e22a714b028f51b9f0eeed756a)) integrity is verified as specified in PKCS \#7 ([\[PKCS7\]](https://go.microsoft.com/fwlink/?LinkId=510681) section 9.3 and \[PKCS7\] section 9.4). ###### Certificate Processing The software publisher’s signing certificate and certificate chain MUST be verified against the following criteria: - - - The certificate chain MUST be validated to a trusted root certificate by using X.509 path validation rules as specified by [\[RFC3280\]](https://go.microsoft.com/fwlink/?LinkId=90414) section 6.Either the signing certificate MUST contain the extended key usage (EKU) (\[RFC3280\] section 4.2.1.13) value for code signing (1.3.6.1.5.5.7.3.3) or there MUST be no EKU fields present in the signing certificate.The certificate chain MUST be within its validity period. If the certificate chain is not within its validity period, the signature MUST have a [**timestamp**](#gt_5799f340-0d0f-4f06-a629-32afbcf95081), and that timestamp MUST be validated according to the [**Timestamp Processing**](#Section_ad34050a39bb4482b973db85586bccd8) rules (section 2.3.2.4.6.2). If the signature has a timestamp, the certificate chain MUST be within its validity period at the timestamp time.If any of these conditions are not met, the signature MUST be treated as invalid. ###### Timestamp Processing A signature with a [**timestamp**](#gt_5799f340-0d0f-4f06-a629-32afbcf95081) **Countersignature** MUST be considered valid if, and only if, it meets the following criteria: - - #### The certificate chain for the **Countersignature** MUST be built according to a trusted root certificate by using X.509 path validation rules as specified by [\[RFC3280\]](https://go.microsoft.com/fwlink/?LinkId=90414) section 6.The [**time stamp authority**](#gt_3247e47d-5652-471c-8c7a-58e90420a0d8) (TSA) certificate that was used to sign the timestamp MUST contain the EKU value for timestamping ("1.3.6.1.5.5.7.3.8").Serialized Certificate Store Structure This section specifies the structures used for storing a [**digital certificate**](#gt_a1dfa70d-7803-413d-8697-c40021a3f3d0), and optionally a list of properties, in a serialized representation as part of the [**digital signature**](#gt_ad0cf6e3-05c3-482d-ab0f-617f91871189) for a [**VBA**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) project. ##### SerializedCertificateEntry *Referenced by: [CertStoreCertificateGroup](#Section_462654f19be347f59c1ea6d328ac52e0)* Specifies a serialized [**digital certificate**](#gt_a1dfa70d-7803-413d-8697-c40021a3f3d0) entry in a serialized [**digital certificate store**](#gt_d6f48603-2840-4629-a813-8ed96f69928b). [TABLE] **id (4 bytes):** An unsigned integer. MUST be 0x00000020. **encodingType (4 bytes):** An unsigned integer that MUST be the value 0x00000001, which specifies ASN.1 encoding \[ITUX680\]. **length (4 bytes):** An unsigned integer that specifies the count of bytes for the **certificate** field. **certificate (variable):** Specifies the certificate data. MUST contain the ASN.1 [\[ITUX680\]](https://go.microsoft.com/fwlink/?LinkId=89923) DER encoding of an X.509 certificate as specified by [\[RFC3280\]](https://go.microsoft.com/fwlink/?LinkId=90414). ##### EndElementMarkerEntry *Referenced by: [DocSigSerializedCertStore](#Section_37d4b77da7d340fe9c3bcd327444f6ff), [VBASigSerializedCertStore](#Section_e88d644c80f84016a2c093fc5b110877)* Specifies a special entry in a serialized [**digital certificate store**](#gt_d6f48603-2840-4629-a813-8ed96f69928b) that marks the end of the store. [TABLE] **id (4 bytes):** An unsigned integer. MUST be 0x00000000. **marker (8 bytes):** A sentinel value 8 bytes in length, the value of which MUST be 0x0000000000000000. ##### SerializedPropertyEntry *Referenced by: [CertStoreCertificateGroup](#Section_462654f19be347f59c1ea6d328ac52e0)* Specifies an entry in a serialized [**digital certificate store**](#gt_d6f48603-2840-4629-a813-8ed96f69928b) that contains data for a property associated with a certificate in the store. [TABLE] **id (4 bytes):** An unsigned integer specifying the identifier of the property. MUST be less than or equal to 0x0000FFFF and MUST NOT be the value 0x00000000 or 0x00000020 because these values specify the special entries [**SerializedCertificateEntry**](#Section_38a1970aa95e49a4bcaf6d8c10ddd5ac) (section 2.3.2.5.1) and [**EndElementMarkerEntry**](#Section_020eb66c88e3466b80f60e3ce84d0544) (section 2.3.2.5.2). **encodingType (4 bytes):** An unsigned integer that MUST be the value 0x00000001, which specifies ASN.1 encoding \[ITUX680\]. **length (4 bytes):** An unsigned integer that specifies the count of bytes for the **value** field. **value (variable):** Specifies the value of the property. This field SHOULD be ignored on read[\<13\>](#Appendix_A_13). ##### CertStoreCertificateGroup *Referenced by: [DocSigSerializedCertStore](#Section_37d4b77da7d340fe9c3bcd327444f6ff), [VBASigSerializedCertStore](#Section_e88d644c80f84016a2c093fc5b110877)* Specifies a grouping of elements in a serialized [**digital certificate store**](#gt_d6f48603-2840-4629-a813-8ed96f69928b) that consists of zero or more properties of a certificate, and the serialized certificate itself. [TABLE] **elementList (variable):** An array of [**SerializedPropertyEntry**](#Section_b8e9c71efe594c568419a2ed2a5858f0) (section 2.3.2.5.3). This array can contain zero or more elements. Elements of this array are read and processed until a **SerializedPropertyEntry.id** is read with the unsigned integer value 0x00000020, which specifies the end of this array and the beginning of the **certificateElement** field. The terminating **SerializedPropertyEntry.id** that is read is actually the **certificateElement.id** field and not a part of this field. **certificateElement (variable):** A [**SerializedCertificateEntry**](#Section_38a1970aa95e49a4bcaf6d8c10ddd5ac) (section 2.3.2.5.1) specifying a [**digital certificate**](#gt_a1dfa70d-7803-413d-8697-c40021a3f3d0) stored in this digital certificate store. ##### VBASigSerializedCertStore *Referenced by: [DigSigInfoSerialized](#Section_30a00273dbee422fb488f4b8430ae046)* The serialized [**digital certificate store**](#gt_d6f48603-2840-4629-a813-8ed96f69928b) specifies structures for storing a digital certificate store containing a single [**digital certificate**](#gt_a1dfa70d-7803-413d-8697-c40021a3f3d0) and, optionally, a list of properties associated with the certificate. [TABLE] **version (4 bytes):** An unsigned integer identifying the version of the structure. MUST be 0x00000000. **fileType (4 bytes):** An unsigned integer that MUST be the value 0x54524543. This value specifies that the structure is a digital certificate store. **certGroup (variable):** A [**CertStoreCertificateGroup**](#Section_462654f19be347f59c1ea6d328ac52e0) (section 2.3.2.5.4) structure that specifies the digital certificate stored in this serialized digital certificate store along with a set of optional properties. **endMarkerElement (12 bytes):** An [**EndElementMarkerEntry**](#Section_020eb66c88e3466b80f60e3ce84d0544) (section 2.3.2.5.2) structure specifying the end of the structure. ### Property Set Storage An [**OLE**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) property set storage is a format as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) that specifies how to store a collection of sets of properties. This section specifies the property sets and data formats used within them that are applicable to this specification. The [**Summary Information**](#Section_11b5612735f44bfaa23f23935a6edf54) (section 2.3.3.2.1) property set SHOULD be written[\<14\>](#Appendix_A_14). The [**Document Summary Information**](#Section_fe59ffd979e944fba1c92466057b05c6) (section 2.3.3.2.2) and [**User Defined**](#Section_54514afbff194348be71395854d4432d) (section 2.3.3.2.3) property sets are optional. #### Property Types This section specifies the data format for property data types that require more detailed specification than what is provided in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc). ##### PropertySetSystemIdentifier Specifies an operating system type and version for a property set. [TABLE] **OSMajorVersion (1 byte):** An unsigned integer specifying the [**major version**](#gt_66583c77-eb07-43c4-8f1b-dd157580db46) number of the operating system that wrote the property set. **OSMinorVersion (1 byte):** An unsigned integer specifying the [**minor version**](#gt_e0d99b53-9426-4a45-8429-b012184a4045) number of the operating system that wrote the property set. **OSType (2 bytes):** An unsigned integer that MUST be 0x0002. ##### VtThumbnailValue *Referenced by: [VtThumbnail](#Section_4af3a094890c4ecc832cf212bfebbfa9)* Specifies data for the [**thumbnail**](#gt_811d0e6b-538c-487d-a54f-44f31e41e172) property. This type conforms to the **ClipboardData** type as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.11](http://msdn.microsoft.com/en-us/library/e5175413-9dad-4a8d-bd1f-058eb301fdc9/), but this section specifies additional detail applicable to this type. [TABLE] **cb (4 bytes):** An unsigned integer that specifies the count of bytes of the remainder of the structure, not including any **padding** field bytes. **cftag (4 bytes):** An unsigned integer specifying the [**clipboard format**](#gt_8f3c1316-2599-4b4f-918a-fa1898835c15) of the data. MUST be 0x00000000, CF_WINDOWS (0xFFFFFFFF), or CF_MACINTOSH (0xFFFFFFFE). A value of 0x00000000 specifies that there is no image data associated with the property. **formatId (4 bytes):** An unsigned integer specifying the format of the data stored in the **cfDataBytes** field. MUST NOT exist if the **cftag** field is 0x00000000. MUST exist if **cftag** is not 0x00000000. If it exists, it MUST be one of the following: CF_METAFILEPICT (0x00000003), CF_ENHMETAFILE (0x0000000E), or CF_JPEG (0x00000333). **cfDataBytes (variable):** An array of bytes containing the data for the thumbnail image. MUST NOT exist if the **cftag** field is 0x00000000. MUST exist if **cftag** is not 0x00000000. If it exists, MUST be (**cb** - 8) bytes in length. The format of the data is specified by **formatId** according to the following table. | formatId Value | Data format | |----|----| | CF_METAFILEPICT (0x00000003) | A **METAFILEPICT** structure as specified by [\[MS-WMF\]](%5bMS-WMF%5d.pdf#Section_4813e7fd52d04f42965f228c8b7488d2). | | CF_ENHMETAFILE (0x0000000E) | Enhanced metafile image data as specified in [\[MS-EMF\]](%5bMS-EMF%5d.pdf#Section_91c257d7c39d4a369b1f63e3f73d30ca). | | CF_JPEG (0x00000333) | [**Joint Photographic Experts Group (JPEG)**](#gt_5eda1f18-8071-4b27-ab0f-07f1fb79199d) image data. | **padding (variable):** An array of bytes. The length of the array MUST be the smallest number of bytes required to pad the size of this structure to a multiple of 4 bytes. The padding SHOULD be 0x00 values, but MAY be undefined values, and MUST be ignored. ##### VtThumbnail Specifies the format for the [**thumbnail**](#gt_811d0e6b-538c-487d-a54f-44f31e41e172) property. This type conforms to the VT_CF **TypedPropertyValue** type as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.15](http://msdn.microsoft.com/en-us/library/f122b9d7-e5cf-4484-8466-83f6fd94b3cc/), but is presented in additional detail here to specify specific constraints on the type of data that can be contained in this type. [TABLE] **wType (2 bytes):** An unsigned integer that MUST be VT_CF (0x0047). **padding (2 bytes):** An unsigned integer that MUST be 0x0000. MUST be ignored. **vtValue (variable):** MUST be a [**VtThumbnailValue**](#Section_427efceff31c4d9e9e4ed28ff9bb6e0b) (section 2.3.3.1.2) structure. ##### Lpstr *Referenced by: [VtString](#Section_60485cf2d8d94a7f99b1d1cf275ae83c)* Specifies data for a null-terminated single-byte character string, the encoding of which corresponds to the value of the enclosing property set’s **CodePage** property ([\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.18.2](http://msdn.microsoft.com/en-us/library/b8910736-7f4a-469a-9644-aed68a71d7d1/)). This type deviates from the **CodePageString** type specified in \[MS-OLEPS\] section [2.5](http://msdn.microsoft.com/en-us/library/a4c32611-5b79-4965-8f50-50639c138e16/) in the way that the **cch** field can be calculated and in the limit to the length of the string. [TABLE] **cch (4 bytes):** An unsigned integer specifying the number of single-byte characters in the **value** field. SHOULD be less than or equal to 0x0000FFFF.[\<15\>](#Appendix_A_15) SHOULD specify the number of characters in the **value** field including the terminating NULL character but not including **padding**. MAY specify the number of characters in both the **value** and **padding** fields.[\<16\>](#Appendix_A_16) **value (variable):** A null-terminated array of single-byte characters defining the string. **padding (variable):** An array of bytes. The length of the array MUST be the smallest number of bytes required to pad the size of the **value** field to a multiple of 4 bytes. The padding SHOULD be 0x00 values, but MAY be undefined values, and MUST be ignored.[\<17\>](#Appendix_A_17) ##### UnalignedLpstr *Referenced by: [VtUnalignedString](#Section_eb04ce67f96b4ea4adf77f75847c7abb), [VtVecUnalignedLpstrValue](#Section_cd95ca9770c748288b5bb86263348026)* Specifies data for a null-terminated single-byte character string, the encoding of which corresponds to the value of the enclosing property set’s **CodePage** property ([\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.18.2](http://msdn.microsoft.com/en-us/library/b8910736-7f4a-469a-9644-aed68a71d7d1/)). This type deviates from the **CodePageString** type specified in \[MS-OLEPS\] section [2.5](http://msdn.microsoft.com/en-us/library/a4c32611-5b79-4965-8f50-50639c138e16/) in the absence of padding bytes and in the limit to the length of the string. [TABLE] **cch (4 bytes):** An unsigned integer specifying the number of single-byte characters in the **value** field. SHOULD be less than or equal to 0x0000FFFF.[\<18\>](#Appendix_A_18) **value (variable):** A null-terminated array of single-byte characters defining the string. ##### Lpwstr *Referenced by: [VtHyperlink](#Section_2225d544e06344ff9f70739f1c14d592), [VtString](#Section_60485cf2d8d94a7f99b1d1cf275ae83c), [VtUnalignedString](#Section_eb04ce67f96b4ea4adf77f75847c7abb), [VtVecLpwstrValue](#Section_112762c273624710afad1f4c8bc6a814)* Specifies data for a null-terminated [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) character string. This type deviates from the **UnicodeString** type specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.7](http://msdn.microsoft.com/en-us/library/9660cb24-953a-4e60-adf2-37cc0e779d19/) in the limit to the length of the string and in the way the length is specified in characters and not bytes. [TABLE] **cch (4 bytes):** An unsigned integer specifying the number of Unicode characters written as the **value** field including the terminating NULL character. SHOULD be less than or equal to 0x0000FFFF.[\<19\>](#Appendix_A_19) **value (variable):** A null-terminated array of Unicode characters defining the string. **padding (variable):** An array of bytes. The length of the array MUST be the smallest number of bytes required to pad the size of the **value** field to a multiple of 4 bytes. The padding SHOULD be 0x00 values, but MAY be undefined values, and MUST be ignored.[\<20\>](#Appendix_A_20) ##### VtVecLpwstrValue *Referenced by: [VtVecLpwstr](#Section_2dc59d31a90349bba1f145fc01c8b8b0)* Specifies data for a property containing an array of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) strings. This type conforms to the (VT_VECTOR \| VT_LPWSTR) **TypedPropertyValue** value format as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.15](http://msdn.microsoft.com/en-us/library/f122b9d7-e5cf-4484-8466-83f6fd94b3cc/), except that the sequence of string structures following the **cElements** field are of type [**Lpwstr**](#Section_e5f5c0973b4440f293ccab4ce521f82d) (section 2.3.3.1.6). [TABLE] **cElements (4 bytes):** An unsigned integer specifying the number of elements in **rgString**. **rgString (variable):** An array of **Lpwstr** (section 2.3.3.1.6). Specifies the list of values for the property. ##### VtVecLpwstr Specifies the format of a property for which the value is a list of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) strings. This type conforms to the (VT_VECTOR \| VT_LPWSTR) **TypedPropertyValue** type as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.15](http://msdn.microsoft.com/en-us/library/f122b9d7-e5cf-4484-8466-83f6fd94b3cc/), except that the format of the strings it contains is as specified in this specification. [TABLE] **wType (2 bytes):** An unsigned integer that MUST be equal to VT_VECTOR \| VT_LPWSTR (0x101F). **padding (2 bytes):** An unsigned integer that MUST be 0x0000. MUST be ignored. **vtValue (variable):** MUST be a [**VtVecLpwstrValue**](#Section_112762c273624710afad1f4c8bc6a814) (section 2.3.3.1.7) structure. ##### VtVecUnalignedLpstrValue *Referenced by: [VtVecUnalignedLpstr](#Section_523af67dd69a4eb1848ba299674ac9b8)* Specifies data for a property containing an array of single-byte character strings. This type conforms to the (VT_VECTOR \| VT_LPSTR) **TypedPropertyValue** value format as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.15](http://msdn.microsoft.com/en-us/library/f122b9d7-e5cf-4484-8466-83f6fd94b3cc/), except that the sequence of string structures following the **cElements** field are of type [**UnalignedLpstr**](#Section_a8f75582c3d34a5bbbca62ed6a05711d) (section 2.3.3.1.5). [TABLE] **cElements (4 bytes):** An unsigned integer specifying the number of elements in **rgString**. **rgString (variable):** An array of **UnalignedLpstr** (section 2.3.3.1.5). Specifies the list of values for the property. ##### VtVecUnalignedLpstr Specifies the format of a property for which the value is a list of single-byte character strings. This type conforms to the (VT_VECTOR \| VT_LPSTR) **TypedPropertyValue** type as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.15](http://msdn.microsoft.com/en-us/library/f122b9d7-e5cf-4484-8466-83f6fd94b3cc/), except that the format of the strings it contains is as specified in this specification. [TABLE] **wType (2 bytes):** An unsigned integer that MUST be VT_VECTOR \| VT_LPSTR (0x101E). **padding (2 bytes):** An unsigned integer that MUST be 0x0000. MUST be ignored. **vtValue (variable):** MUST be a [**VtVecUnalignedLpstrValue**](#Section_cd95ca9770c748288b5bb86263348026) (section 2.3.3.1.9) structure. ##### VtString Specifies the format of a property for which the value is a string. [TABLE] **stringType (2 bytes):** An unsigned integer that MUST be VT_LPSTR (0x001E) or VT_LPWSTR (0x001F). **padding (2 bytes):** An unsigned integer that MUST be 0x0000. MUST be ignored. **stringValue (variable):** A structure that determines its type depending on the value of the **stringType** field according to the following table. | stringType | stringValue type | |----|----| | VT_LPSTR (0x001E) | [**Lpstr**](#Section_fac324c9ff39442ebd181a91a723a818) (section 2.3.3.1.4) | | VT_LPWSTR (0x001F) | [**Lpwstr**](#Section_e5f5c0973b4440f293ccab4ce521f82d) (section 2.3.3.1.6) | ##### VtUnalignedString *Referenced by: [VtHeadingPair](#Section_8d8db7dc9a0c4bcc9ad5a2937bb559b0)* Specifies the format of a property for which the value is a string but where the **stringValue** field is not padded to any particular length if it is a single-byte character string type. [TABLE] **stringType (2 bytes):** An unsigned integer that MUST be VT_LPSTR (0x001E) or VT_LPWSTR (0x001F). **padding (2 bytes):** An unsigned integer that MUST be 0x0000. MUST be ignored. **stringValue (variable):** A structure that determines its type depending on the value of the **stringType** field according to the following table. | stringType | stringValue type | |----|----| | VT_LPSTR (0x001E) | [**UnalignedLpstr**](#Section_a8f75582c3d34a5bbbca62ed6a05711d) (section 2.3.3.1.5) | | VT_LPWSTR (0x001F) | [**Lpwstr**](#Section_e5f5c0973b4440f293ccab4ce521f82d) (section 2.3.3.1.6) | ##### VtHeadingPair *Referenced by: [VtVecHeadingPairValue](#Section_7eaa201d3fe149178e393690a3a36c11)* Specifies data for a heading pair for a property. [TABLE] **headingString (variable):** A structure of type [**VtUnalignedString**](#Section_eb04ce67f96b4ea4adf77f75847c7abb) (section 2.3.3.1.12) specifying the header string. **headerParts (8 bytes):** A VT_I4 **TypedPropertyValue** structure as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.15](http://msdn.microsoft.com/en-us/library/f122b9d7-e5cf-4484-8466-83f6fd94b3cc/). The **Value** field of the **TypedPropertyValue** structure specifies the number of document parts associated with this header. ##### VtVecHeadingPairValue *Referenced by: [VtVecHeadingPair](#Section_3aaaf9e84f1a42fa9359fe0ab0c1cccc)* Specifies data for the heading pair property. This type conforms to the (VT_VECTOR \| VT_VARIANT) **TypedPropertyValue** value format as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.15](http://msdn.microsoft.com/en-us/library/f122b9d7-e5cf-4484-8466-83f6fd94b3cc/), but this section specifies additional detail specifically applicable to this type. [TABLE] **cElements (4 bytes):** An unsigned integer specifying the count of elements in the **rgHeadingPairs** field. The number of elements in **rgHeadingPairs** MUST be half of this value. This value MUST be even. **rgHeadingPairs (variable):** An array of [**VtHeadingPair**](#Section_8d8db7dc9a0c4bcc9ad5a2937bb559b0) (section 2.3.3.1.13). Specifies the list of heading pairs for the property. ##### VtVecHeadingPair Specifies the format for a property representing the headers corresponding to the [**GKPIDDSI_DOCPARTS**](#Section_3ef02e83afef4b6c9585c109edd24e07) property data (section 2.3.3.2.2.1). This type conforms to the (VT_VECTOR \| VT_VARIANT) **TypedPropertyValue** type as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.15](http://msdn.microsoft.com/en-us/library/f122b9d7-e5cf-4484-8466-83f6fd94b3cc/), but is presented in additional detail here to specify specific constraints on the type and format of data that can be contained in this type. Refer to the **GKPIDDSI_HEADINGPAIR** (section 2.3.3.2.2.1) and **GKPIDDSI_DOCPARTS** (section 2.3.3.2.2.1) properties for additional details. [TABLE] **wType (2 bytes):** An unsigned integer that MUST be VT_VECTOR \| VT_VARIANT (0x100C). **padding (2 bytes):** An unsigned integer that MUST be 0x0000. MUST be ignored. **vtValue (variable):** MUST be a [**VtVecHeadingPairValue**](#Section_7eaa201d3fe149178e393690a3a36c11) (section 2.3.3.1.14) structure. ##### VtDigSigValue *Referenced by: [VtDigSig](#Section_e1f6b35d7e064dbc880ba074fabcd06d)* Specifies the data for a [**VBA**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) [**digital signature**](#gt_ad0cf6e3-05c3-482d-ab0f-617f91871189) property. This type conforms to the VT_BLOB **TypedPropertyValue** value format as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.15](http://msdn.microsoft.com/en-us/library/f122b9d7-e5cf-4484-8466-83f6fd94b3cc/), but this section specifies additional detail applicable to this type. [TABLE] **cb (4 bytes):** An unsigned integer that specifies the size in bytes of **vbaDigSig**. MUST be equal to **vbaDigSig.cb** + 8. **vbaDigSig (variable):** A [**DigSigBlob**](#Section_bc21c922b7ae473690aa86afb6403462) (section 2.3.2.2) structure that specifies a VBA digital signature. ##### VtDigSig Specifies the format for a property representing a [**VBA**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) [**digital signature**](#gt_ad0cf6e3-05c3-482d-ab0f-617f91871189). This type conforms to the VT_BLOB **TypedPropertyValue** type as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.15](http://msdn.microsoft.com/en-us/library/f122b9d7-e5cf-4484-8466-83f6fd94b3cc/), but is presented in additional detail here to further specify the content of the property. [TABLE] **wType (2 bytes):** An unsigned integer that MUST be equal to VT_BLOB (0x0041). **padding (2 bytes):** An unsigned integer that MUST be 0x0000. MUST be ignored. **vtValue (variable):** MUST be a [**VtDigSigValue**](#Section_a7c3987feaa64f8cbc5cf0dd124eb32f) (section 2.3.3.1.16) structure. ##### VtHyperlink *Referenced by: [VecVtHyperlink](#Section_754880cc03d448e794fcd9f6573f11af)* Specifies the data format for a [**hyperlink**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) for a property. [TABLE] **dwHash (8 bytes):** MUST be a VT_I4 **TypedPropertyValue** as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.15](http://msdn.microsoft.com/en-us/library/f122b9d7-e5cf-4484-8466-83f6fd94b3cc/). The **Value** field of this structure SHOULD be calculated as specified in the [Hyperlink Hash](#Section_beb6ef90fb234c9f9d3acf1d68616441) (section 2.4.2) section with the **hlink1** field and **hlink2** field string values given as input.[\<21\>](#Appendix_A_21) **dwApp (8 bytes):** MUST be a VT_I4 **TypedPropertyValue** as specified in \[MS-OLEPS\] section 2.15. The **Value** field of this structure is implementation specific.[\<22\>](#Appendix_A_22) **dwOfficeArt (8 bytes):** MUST be a VT_I4 **TypedPropertyValue** as specified in \[MS-OLEPS\] section 2.15. The **Value** field of this structure MUST be a **MSOSPID** type value ([\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) section 2.1.2) specifying the identifier of the shape (\[MS-ODRAW\] section 2.2.31) to which this hyperlink applies in the document. If this hyperlink does not apply to a shape, the **Value** field of this structure MUST be 0x00000000. **dwInfo (8 bytes):** MUST be a VT_I4 **TypedPropertyValue** as specified in \[MS-OLEPS\] section 2.15. The **Value** field of this structure is implementation specific.[\<23\>](#Appendix_A_23) The high-order 2-byte integer of the **Value** field of this structure SHOULD be 0x0000. The unsigned 2-byte integer specified by the high two bytes of this value can be written as 0x0000 by an application that saves the entire file, as it specifies that the hyperlink is in sync with the document contents. If a process changes the hyperlink property element without a corresponding change to the related document content such that the hyperlink needs to be fixed in the document the next time the document is loaded, this value needs to be changed to 0x0001 by the process. If such a process wishes to specify that the hyperlink is to be removed from the document the next time the document is loaded, this value needs to be changed to 0x0002 by the process. **hlink1 (variable):** MUST be a [**VtString**](#Section_60485cf2d8d94a7f99b1d1cf275ae83c) structure (section 2.3.3.1.11) with **hlink1.wType** equal to VT_LPWSTR. **hlink1.stringValue** specifies the [**hyperlink target**](#gt_8ab050fe-a310-4912-ba19-859186089962). **hlink2 (variable):** MUST be a **VtString** structure (section 2.3.3.1.11) with **hlink2.wType** equal to VT_LPWSTR. **hlink2.stringValue** specifies the [**hyperlink location**](#gt_8b9cd56d-fa77-4360-a03f-9a2d5b5e0ff9). ##### VecVtHyperlink *Referenced by: [VtHyperlinkValue](#Section_f65d95215c8d4888a23ecc1b9f9d7da5)* Specifies the data format for an array of [**hyperlinks**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e). This type conforms to the (VT_VECTOR \| VT_VARIANT) **TypedPropertyValue** value format as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.15](http://msdn.microsoft.com/en-us/library/f122b9d7-e5cf-4484-8466-83f6fd94b3cc/), but this section specifies additional details specific to this type. [TABLE] **cElements (4 bytes):** An unsigned integer specifying the count of elements in the **rgHyperlink** field. The number of elements in **rgHyperlink** MUST be 1/6 of this value. This value MUST be evenly divisible by 6. **rgHyperlink (variable):** An array of [**VtHyperlink**](#Section_2225d544e06344ff9f70739f1c14d592) (section 2.3.3.1.18). Specifies the list of hyperlinks for the property. ##### VtHyperlinkValue *Referenced by: [VtHyperlinks](#Section_4df4d1a8bb4746bdacd7944e817338e7)* Specifies the data for a [**hyperlinks**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) property. This type conforms to the VT_BLOB **TypedPropertyValue** value format as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.15](http://msdn.microsoft.com/en-us/library/f122b9d7-e5cf-4484-8466-83f6fd94b3cc/), but this section specifies additional detail applicable to this type. [TABLE] **cbData (4 bytes):** An unsigned integer that specifies the size in bytes of **vecHyperlink**. **vecHyperlink (variable):** MUST be a [**VecVtHyperlink**](#Section_754880cc03d448e794fcd9f6573f11af) structure (section 2.3.3.1.19). ##### VtHyperlinks Specifies the format for a property representing a set of [**hyperlinks**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e). This type conforms to the VT_BLOB **TypedPropertyValue** type as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.15](http://msdn.microsoft.com/en-us/library/f122b9d7-e5cf-4484-8466-83f6fd94b3cc/), but is presented in more detail here to further specify the contents of the data in this type. [TABLE] **wType (2 bytes):** An unsigned integer that MUST be equal to VT_BLOB (0x0041). **padding (2 bytes):** An unsigned integer that MUST be 0x0000. MUST be ignored. **vtValue (variable):** MUST be a [**VtHyperlinkValue**](#Section_f65d95215c8d4888a23ecc1b9f9d7da5) structure (section 2.3.3.1.20). #### OLE Property Sets This section defines the format of a property set storage [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc). This format applies to the [**Summary Information**](#Section_11b5612735f44bfaa23f23935a6edf54) (section 2.3.3.2.1) and [**Document Summary Information**](#Section_fe59ffd979e944fba1c92466057b05c6) (section 2.3.3.2.2) streams. ##### Summary Information Property Set This section defines a simple [**OLE**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) property set as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) that conforms to the well-known property set format SummaryInformation as specified in \[MS-OLEPS\] section [2.23](http://msdn.microsoft.com/en-us/library/e5484a83-3cc1-43a6-afcf-6558059fe36e/) and \[MS-OLEPS\] section [2.25.1](http://msdn.microsoft.com/en-us/library/f7933d28-2cc4-4b36-bc23-8861cbcd37c4/). This specifies that the property set has the identifier [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) FMTID_SummaryInformation and is contained in the document [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) named "\005SummaryInformation". It contains a fixed set of recognized properties, which are generally specified in the \[MS-OLEPS\] specification, but are specified in the following section with more details regarding their use or deviations from the simple OLE property set format pursuant to this specification. The format of this property set is as specified in \[MS-OLEPS\], except where stated otherwise in the following section. In addition, this property set MUST have the following: - - - This property set MUST have its **PropertySetStream** structure **Version** field set to 0x00000000.This property set MUST have its **PropertySetStream** structure **CLSID** field set to [**GUID_NULL**](#gt_b9d97d88-9398-4450-9e92-247073ce0362).This property set MUST have a **PropertySetSystemIdentifier** structure (section [2.3.3.1.1](#Section_6ac486b48d634cdebd729c2306a482fe)) for its **PropertySetStream** structure **SystemIdentifier** field.For additional information about the OLE property set storage format, see \[MS-OLEPS\]. ###### PIDSI Specifies the list of properties that can be defined in the [**Summary Information property set**](#Section_11b5612735f44bfaa23f23935a6edf54) (section 2.3.3.2.1). This set MUST NOT contain a **Dictionary** property ([\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.18.1](http://msdn.microsoft.com/en-us/library/4177a4bc-5547-49fe-a4d9-4767350fd9cf/)). All properties are optional, except the **GKPIDSI_CODEPAGE** property which MUST be written if the **Summary Information property set** (section 2.3.3.2.1) is present. All persisted string type properties ([**Lpstr**](#Section_fac324c9ff39442ebd181a91a723a818) (section 2.3.3.1.4), [**UnalignedLpstr**](#Section_a8f75582c3d34a5bbbca62ed6a05711d) (section 2.3.3.1.5), and [**Lpwstr**](#Section_e5f5c0973b4440f293ccab4ce521f82d) (section 2.3.3.1.6)) MUST share the same [**code page**](#gt_210637d9-9634-4652-a935-ded3cd434f38) encoding as specified by the **GKPIDSI_CODEPAGE** property. If the string properties are persisted as **Lpwstr** (section 2.3.3.1.6) type properties, the **GKPIDSI_CODEPAGE** property MUST be set to CP_WINUNICODE (0x04B0). No order in persistence of the properties is enforced. All properties are persisted as **TypedPropertyValue** types as specified in \[MS-OLEPS\] section [2.15](http://msdn.microsoft.com/en-us/library/f122b9d7-e5cf-4484-8466-83f6fd94b3cc/), except where indicated otherwise for the purpose of additional clarification or deviation from the specification. The **Value** column of the following table specifies the value of the **PropertyIdentifier** field for the **PropertyIdentifierAndOffset** structure (\[MS-OLEPS\] section [2.19](http://msdn.microsoft.com/en-us/library/f59e6c94-a0ae-4d1b-85d3-f01c35779a22/)) for the specified property. The **Meaning** column of the following table specifies the property data type and the property’s meaning. The property data type specifies the format of the **Property** field of the **PropertySet** structure (\[MS-OLEPS\] section [2.20](http://msdn.microsoft.com/en-us/library/aefcbddf-f299-4f5e-a9da-65ce4ca55075/)) for the given property. [TABLE] ##### Document Summary Information Property Set This section defines a simple [**OLE**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) property set as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) containing application-defined properties. This property set conforms to \[MS-OLEPS\] section [2.21](http://msdn.microsoft.com/en-us/library/6e65d6fa-6044-4e23-ae71-d65d1e3b1249/) and \[MS-OLEPS\] section [2.23](http://msdn.microsoft.com/en-us/library/e5484a83-3cc1-43a6-afcf-6558059fe36e/) with regards to the [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) name requirements and format identifier [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) for the FMTID_DocSummaryInformation property set. The Document Summary Information property set is contained in the document stream named **"\005DocumentSummaryInformation"** and contains a fixed set of recognized properties, which are specified in the following section. In addition, this property set MUST have the following: - - - This property set MUST have its **PropertySetStream** structure **Version** field set to 0x00000000.This property set MUST have its **PropertySetStream** structure **CLSID** field set to [**GUID_NULL**](#gt_b9d97d88-9398-4450-9e92-247073ce0362).This property set MUST have a [**PropertySetSystemIdentifier**](#Section_6ac486b48d634cdebd729c2306a482fe) structure (section 2.3.3.1.1) for its **PropertySetStream** structure **SystemIdentifier** field.The total size of this property set’s **PropertySet** structure (\[MS-OLEPS\] section [2.20](http://msdn.microsoft.com/en-us/library/aefcbddf-f299-4f5e-a9da-65ce4ca55075/)) MUST be padded to a multiple of 4 bytes. The padding, if needed, MUST be located after the final property value of the property set and MUST be the minimum size required to produce a **PropertySet** structure with a size that is a multiple of 4 bytes. The contents of the padding are undefined and MUST be ignored. The **PropertySet** structure’s **Size** field MUST include the count of padding bytes in its calculation. For additional information about the OLE property set storage format, see \[MS-OLEPS\]. ###### PIDDSI Specifies the list of properties that can be defined in the [**Document Summary Information property set**](#Section_fe59ffd979e944fba1c92466057b05c6) (section 2.3.3.2.2). This set MUST NOT contain a **Dictionary** property ([\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.18.1](http://msdn.microsoft.com/en-us/library/4177a4bc-5547-49fe-a4d9-4767350fd9cf/)). All properties are optional, except the **GKPIDDSI_CODEPAGE** property (section 2.3.3.2.2.1) which MUST be written if the **Document Summary Information property set** (section 2.3.3.2.2) is present. All persisted string type properties ([**Lpstr**](#Section_fac324c9ff39442ebd181a91a723a818) (section 2.3.3.1.4), [**UnalignedLpstr**](#Section_a8f75582c3d34a5bbbca62ed6a05711d) (section 2.3.3.1.5), and [**Lpwstr**](#Section_e5f5c0973b4440f293ccab4ce521f82d) (section 2.3.3.1.6)) MUST share the same [**code page**](#gt_210637d9-9634-4652-a935-ded3cd434f38) encoding as specified by the **GKPIDDSI_CODEPAGE** property. If the string properties are persisted as **Lpwstr** (section 2.3.3.1.6) type properties, the **GKPIDDSI_CODEPAGE** property MUST be set to CP_WINUNICODE (0x04B0). No order in persistence of properties is enforced. All properties are persisted as **TypedPropertyValue** types as specified in \[MS-OLEPS\] section [2.15](http://msdn.microsoft.com/en-us/library/f122b9d7-e5cf-4484-8466-83f6fd94b3cc/), except where indicated otherwise for the purpose of additional clarification or deviation from the specification. The **Value** column of the following table specifies the value of the **PropertyIdentifier** field for the **PropertyIdentifierAndOffset** structure (\[MS-OLEPS\] section [2.19](http://msdn.microsoft.com/en-us/library/f59e6c94-a0ae-4d1b-85d3-f01c35779a22/)) for the specified property. The **Meaning** column of the following table specifies the property type and description. The type specifies the format of the **Property** field of the **PropertySet** structure (\[MS-OLEPS\] section [2.20](http://msdn.microsoft.com/en-us/library/aefcbddf-f299-4f5e-a9da-65ce4ca55075/)) for the given property. [TABLE] ##### User Defined Property Set This section defines a simple [**OLE**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) property set, as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc), containing arbitrary user-defined properties. This property set conforms to \[MS-OLEPS\] section [2.21](http://msdn.microsoft.com/en-us/library/6e65d6fa-6044-4e23-ae71-d65d1e3b1249/) and \[MS-OLEPS\] section [2.23](http://msdn.microsoft.com/en-us/library/e5484a83-3cc1-43a6-afcf-6558059fe36e/) with regards to [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) name requirements and format identifier [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) for the FMTID_UserDefinedProperties property set. The User Defined property set is contained in the document stream named **"\005DocumentSummaryInformation"**. It contains properties of arbitrary type and value (within the constraints specified in section [2.3.3.2.3.1](#Section_1edd5ada132a4108af3323225e159aa8)), and assigned any property name that meets the \[MS-OLEPS\] specification except for those names that are reserved as specified in section [2.3.3.2.3.2](#Section_3394ba979ea34b52ba45555bb5b8e94c). This property set also supports the concept of linked properties that use two property entries, one of which does not have an associated property name. The specification for these properties is specified in section [2.3.3.2.3.3](#Section_97ac7ca64fab4fb582527bb52a36fde2). Properties stored in this property set have an effective **PropertyIdentifier** maximum of 0x00FFFFFF because of reserved high-order bits for property entry link specification. In addition, this property set MUST have the following: - - - This property set MUST have its **PropertySetStream** structure **Version** field set to 0x00000000.This property set MUST have its **PropertySetStream** structure **CLSID** field set to [**GUID_NULL**](#gt_b9d97d88-9398-4450-9e92-247073ce0362).This property set MUST have a [**PropertySetSystemIdentifier**](#Section_6ac486b48d634cdebd729c2306a482fe) structure (section 2.3.3.1.1)for its **PropertySetStream** structure **SystemIdentifier** field.The total size of this property set’s **PropertySet** structure (\[MS-OLEPS\] section [2.20](http://msdn.microsoft.com/en-us/library/aefcbddf-f299-4f5e-a9da-65ce4ca55075/)) MUST be padded to a multiple of 4 bytes. The padding, if needed, MUST be located after the final property value of the property set and MUST be the minimum size required to produce a **PropertySet** structure with a size that is a multiple of 4 bytes. The contents of the padding are undefined and MUST be ignored. The **PropertySet** structure’s **Size** field MUST include the count of padding bytes in its calculation. For additional information about the OLE property set storage format, see \[MS-OLEPS\]. ###### User Defined Property Set Constraints The [User Defined property set](#Section_54514afbff194348be71395854d4432d) (section 2.3.3.2.3) is a location where user-defined properties can be persisted by associating arbitrary property names to data of arbitrary types. There are limits on the format the data can take, which are specified in this section. ####### Required Properties Because the format of the [User Defined property set](#Section_54514afbff194348be71395854d4432d) (section 2.3.3.2.3) MUST associate a name with each property (except for the **Dictionary** and **CodePage** properties and [links](#Section_97ac7ca64fab4fb582527bb52a36fde2) associated with properties), the property set MUST have a **Dictionary** property as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.18.1](http://msdn.microsoft.com/en-us/library/4177a4bc-5547-49fe-a4d9-4767350fd9cf/) to make this association, and MUST follow the rules as specified in \[MS-OLEPS\] regarding property name and property identifier uniqueness. The User Defined property set (section 2.3.3.2.3) MUST also contain the **CodePage** property as specified in \[MS-OLEPS\] section [2.18.2](http://msdn.microsoft.com/en-us/library/b8910736-7f4a-469a-9644-aed68a71d7d1/). ####### Supported Types The [User Defined property set](#Section_54514afbff194348be71395854d4432d) (section 2.3.3.2.3) does not support every property type defined in the [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) specification. Each property in this property set (with the exception of the **Dictionary** and **CodePage** properties) MUST be in one of the following formats: - - - - - - - ###### [**VtString**](#Section_60485cf2d8d94a7f99b1d1cf275ae83c) (section 2.3.3.1.11)**TypedPropertyValue** (\[MS-OLEPS\] section [2.15](http://msdn.microsoft.com/en-us/library/f122b9d7-e5cf-4484-8466-83f6fd94b3cc/)), the type of which MUST be one of the following types:VT_I4 (0x0003)VT_R8 (0x0005)VT_BOOL (0x000B)VT_FILETIME (0x0040)VT_BLOB (0x0041)Reserved Properties The [User Defined property set](#Section_54514afbff194348be71395854d4432d) (section 2.3.3.2.3) has a number of names that are reserved for specific data. These names MUST only be used to specify the data for which the names are reserved. All of these properties are optional and can be absent. The reserved names and the data they specify are as specified in the following tables. [TABLE] The following properties are associated with [**document workspace**](#gt_4669f004-eb55-4d2a-b7d3-f9de045e4614) management. All of these properties MAY be ignored.[\<57\>](#Appendix_A_57) [TABLE] The following properties are associated with [**smart document**](#gt_cc9fe152-6a63-4555-91f1-1543ff84035d) solutions. | Reserved name | Format and description | |----|----| | Solution ID | MUST be a **VtString** property. It specifies the identifier[\<59\>](#Appendix_A_59) for the associated smart document solution. This property can be used to check whether the specified smart document solution is already installed and, if so, use the existing solution information to determine if the solution needs to be updated. If it is not previously installed, the solution is installed based on the value of the "Solution URL" property. MAY be ignored[\<60\>](#Appendix_A_60). For more information about smart documents, see [\[MSDN-SDO\]](https://go.microsoft.com/fwlink/?LinkId=120839). The length of the property’s **VtString.stringValue.value** field MUST be less than or equal to 51 characters, including the terminating NULL character. | | Solution URL | MUST be a **VtString** property. It specifies the path to an [**XML expansion pack**](#gt_fdf0febb-e3dd-45f5-a3fa-912b1baf9bac) [**manifest**](#gt_d1a20cdc-cced-44de-a041-857fb9054856) file, which defines the contents of the smart document solution associated with the document. MAY be ignored[\<61\>](#Appendix_A_61). For more information about XML expansion pack manifest files, see \[MSDN-SDO\]. The length of the property’s **VtString.stringValue.value** field MUST be less than or equal to 256 characters, including the terminating NULL character. | | Solution Template ID | MUST be a **VtString** property. It specifies the identifier of a document template installed as part of the XML expansion pack. This property is used to ensure that the local copy of the document template installed as part of the XML expansion pack is updated when the document template referenced by the manifest file is updated. MAY be ignored[\<62\>](#Appendix_A_62). For more information about XML expansion pack manifest files, see \[MSDN-SDO\]. The length of the property’s **VtString.stringValue.value** field MUST be less than or equal to 256 characters, including the terminating NULL character. | | Other Solution ID | MUST be a **VtString** property. It specifies the identifier[\<63\>](#Appendix_A_63) of a solution of type 'other' installed as a part of a XML expansion pack. For more information about XML expansion pack and types of solutions, see \[MSDN-SDO\]. This property is used when the solution itself does not affect the document behavior but it can be used to check if the referenced solution needs to be updated whenever the document is loaded. MAY be ignored[\<64\>](#Appendix_A_64). The length of the property’s **VtString.stringValue.value** field MUST be less than or equal to 51 characters, including the terminating NULL character. | The following properties are associated with [**managed code**](#gt_5293dd75-4296-4f8b-bb9a-cfef88c3c44d) document [**add-in**](#gt_a3be101e-9d37-484a-a5e6-b70d559146c6) solutions[\<65\>](#Appendix_A_65). For more information about managed code document add-in solutions, see [\[MSDN-AVSTOS\]](https://go.microsoft.com/fwlink/?LinkId=121211). These properties MUST both exist if present. [TABLE] The following properties specify information about a document that has been sent by using email, either for review or as an attachment, from an author to a reviewer or from a reviewer back to the author. These properties MAY be ignored.[\<68\>](#Appendix_A_68) [TABLE] Associated properties with sensitivity labels are specified in [\[MS-OI29500\]](%5bMS-OI29500%5d.pdf#Section_1fd4a662862349c082f018fa91b413b8) section 2.1.31. ###### Linked Properties The specification for a simple [**OLE**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) property set storage as specified in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) specifies that properties contained in a property set storage can be named, when that property set storage contains the special **Dictionary** property. As specified previously, the [**User Defined property set**](#Section_54514afbff194348be71395854d4432d) (section 2.3.3.2.3) MUST contain a **Dictionary** property, and all properties of the property set except those that are special properties as specified in \[MS-OLEPS\] section [2.18](http://msdn.microsoft.com/en-us/library/9389a815-d71c-4dd2-b272-2b3a8177f004/) have names. However, the properties in this property set, excluding the special properties and [**Reserved Properties**](#Section_3394ba979ea34b52ba45555bb5b8e94c) (section 2.3.3.2.3.2), can also be linked, meaning they receive their value from document content instead of from explicit value assignment. A link for any property that allows it, if applicable, MUST be specified by creating an additional entry in the property set that is unnamed (that is, does not have an associated entry in the **Dictionary** property table). The **PropertyIdentifier** (\[MS-OLEPS\] section [2.19](http://msdn.microsoft.com/en-us/library/f59e6c94-a0ae-4d1b-85d3-f01c35779a22/)) for an entry created for this purpose is equal to its associated property’s **PropertyIdentifier** combined with the value **0x01000000** by using the bitwise **OR** operation. A property’s link entry MUST be in [**VtString**](#Section_60485cf2d8d94a7f99b1d1cf275ae83c) (section 2.3.3.1.11) format. The presence of such an associated link for a given property specifies that the property, when written, MUST generate its value from the document content to which it is linked.[\<71\>](#Appendix_A_71) On document load, pursuant to the specification of the [**GKPIDDSI_LINKSDIRTY**](#Section_3ef02e83afef4b6c9585c109edd24e07) property flag (section 2.3.3.2.2.1), the application MUST update the linked document content in accordance with the new value of any linked property that was changed outside of the application. ### SmartTag Objects The [**smart tags**](#gt_2f57a49a-d503-4605-8798-0e53bd637609) are customer-defined semantics which can be embedded in a document. Smart tags allow semantic information to be added around words or types of data (for example, dates, phone numbers or addresses) within a document to provide information about the type of data contained within. #### PropertyBagStore This structure specifies the shared data for the [**smart tags**](#gt_2f57a49a-d503-4605-8798-0e53bd637609) embedded in the document. [TABLE] **cFactoidType (4 bytes):** Unsigned integer specifying the count of elements in the **factoidTypes** member. **factoidTypes (variable):** An array of [**FactoidType**](#Section_e20c3d1400c8439b87a07cd8bc7dfdd9) (section 2.3.4.2). Specifies the list of smart tag types. **cbHdr (2 bytes):** Unsigned integer specifying the size in bytes of the **cbHdr**, **sVer**, **cfactoid**, and **cste** fields. MUST be 0xC. **sVer (2 bytes):** Unsigned integer specifying the version number of the structure. The high-order byte specifies the [**major version**](#gt_66583c77-eb07-43c4-8f1b-dd157580db46) number. The low-order byte specifies the [**minor version**](#gt_e0d99b53-9426-4a45-8429-b012184a4045) number. MUST be 0x0100. **cfactoid (4 bytes):** Unsigned integer reserved for future use. MUST be ignored. **cste (4 bytes):** Unsigned integer specifying the count of elements in the **stringTable** field. **stringTable (variable):** An array of [**PBString**](#Section_0f70d2f799e9485398feedfc98825792) (section 2.3.4.5). Specifies the list of strings. Elements of this table are referenced by their indices to form key/value pairs by the **keyIndex** and **valueIndex** fields in [**Property**](#Section_61d78938ed384cb39c6b9f42fdd24894) (section 2.3.4.4), which is in the **properties** field of [**PropertyBag**](#Section_5dbba3b5db16449ebb6286967fa7d21b) (section 2.3.4.3). #### FactoidType *Referenced by: [PropertyBagStore](#Section_e9e83dea3953448f8cdd2392b6ba76a3)* This structure specifies the type of [**smart tag**](#gt_2f57a49a-d503-4605-8798-0e53bd637609). [TABLE] **cbFactoid (4 bytes):** Unsigned integer specifying the count of total bytes, excluding itself, in the **FactoidType** structure. **id (4 bytes):** Unsigned integer specifying the identifier of this smart tag type. There is a many-to-one mapping from the **PropertyBag** (section [2.3.4.3](#Section_5dbba3b5db16449ebb6286967fa7d21b)) to **FactoidType** using their respective **id** fields. MUST be less than or equal to 0xFFFF. **rgbUri (variable):** A **PBString** structure (section [2.3.4.5](#Section_0f70d2f799e9485398feedfc98825792)) specifying the [**XML namespace**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) [**Uniform Resource Identifier (URI)**](#gt_e18af8e8-01d7-4f91-8a1e-0fb21b191f95) for the smart tag type. **rgbTag (variable):** A **PBString** structure (section 2.3.4.5) specifying the tag name for the smart tag type. **rgbDownLoadURL (variable):** A **PBString** structure (section 2.3.4.5) specifying the [**URL**](#gt_433a4fb7-ef84-46b0-ab65-905f5e3a80b1) to download the particular smart tag type. #### PropertyBag This structure specifies the [**smart tag**](#gt_2f57a49a-d503-4605-8798-0e53bd637609) data. [TABLE] **id (2 bytes):** Unsigned integer specifying the **id** of [**FactoidType**](#Section_e20c3d1400c8439b87a07cd8bc7dfdd9) (section 2.3.4.2) in the **factoidTypes** list of the [**PropertyBagStore**](#Section_e9e83dea3953448f8cdd2392b6ba76a3) (section 2.3.4.1). **cProp (2 bytes):** Unsigned integer specifying the count of elements in the **properties** field. **cbUnknown (2 bytes):** Unused, reserved for future use. MUST be 0x0 and MUST be ignored. **properties (variable):** An array of [**Property**](#Section_61d78938ed384cb39c6b9f42fdd24894) (section 2.3.4.4). It is a list of key/value indexes into the **stringTable** field of the **PropertyBagStore** (section 2.3.4.1) structure. #### Property *Referenced by: [PropertyBag](#Section_5dbba3b5db16449ebb6286967fa7d21b)* This structure specifies the indexes into the string table entries of the **stringTable** field in the [**PropertyBagStore**](#Section_e9e83dea3953448f8cdd2392b6ba76a3) (section 2.3.4.1) to form a key/value pair. It is used by the [**smart tag recognizer**](#gt_31f2a874-4490-4c2c-9e2c-6267f373bf5c) to store additional information that relates to the smart tag in a collection of key/value pairs, known as a property bag. This information can be later used to perform common tasks for the data type. [TABLE] **keyIndex (4 bytes):** Unsigned integer specifying the key index. **valueIndex (4 bytes):** Unsigned integer specifying the value index. #### PBString *Referenced by: [FactoidType](#Section_e20c3d1400c8439b87a07cd8bc7dfdd9), [PropertyBagStore](#Section_e9e83dea3953448f8cdd2392b6ba76a3)* This structure specifies a null-terminated string encoded either using a [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) or [**ANSI character set**](#gt_100cd8a6-5cb1-4895-9de6-e4a3c224a583) format. [TABLE] **cch (15 bits):** Specifies the count of characters in the string **rgxch**. **A - fAnsiString (1 bit):** If set to 0x1 the string **rgxch** MUST be an ANSI character set string. If set to 0x0 then it MUST be a Unicode string. **rgxch (variable):** A null-terminated ANSI character set or a Unicode string depending on the value of **fAnsiString** field. ### RefEdit Control A TextBox control, as specified by a **MorphData** control structure in [\[MS-OFORMS\]](%5bMS-OFORMS%5d.pdf#Section_9c79701a8c3e4429a139b60ac3a1d50a) section 2.2.5, with the following exceptions: - - **ShowDropButtonWhen**, specified in \[MS-OFORMS\] section 2.5.77, MUST have the value fmShowDropButtonWhenAlways.**DropButtonStyle**, specified in \[MS-OFORMS\] section 2.5.22, MUST have the value fmDropButtonStyleReduce.All other properties of a **RefEdit** control are specified to have the same file format default values as a **MorphData** control structure, as specified in \[MS-OFORMS\] section 2.2.5, with a **DisplayStyle** property value of "fmDisplayStyleText", as specified in \[MS-OFORMS\] section 2.5.20. ### Custom XML Data Storage The Custom XML Data Storage specifies how to store a collection of XML fragments. It can be used to roundtrip arbitrary custom XML data with the document. This [**storage**](#gt_63525252-3f66-4459-9b64-5b77f57b2f84) SHOULD[\<72\>](#Appendix_A_72) be created to store any XML fragment. The name of this storage MUST be "MsoDataStore". Within this storage, zero or more sub-storages exist. The name of each of these sub-storages MUST be unique. Each of these sub-storages MUST contain two [**streams**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) within it as specified in section [2.3.6.1](#Section_4bd09eb4a447471ebb34b6be107ab54d) and [2.3.6.2](#Section_8d4c97e66af4473aa6acef7ce89ccbf2) respectively. #### Custom XML Data Storage Item The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "Item". An instance of this stream contains an XML fragment. Custom XML Data Storage items whose root namespace appears in the following table are further specified. | Root namespace | Explanation | |----|----| | http://schemas.microsoft.com/office/2006/customDocumentInformationPanel | [Custom Property Editor](#Section_85d6920daf9f49d9873bbab3e41ae0ff) (section 2.3.6.1.1) | | http://schemas.microsoft.com/office/2006/metadata/customXsn | [Custom Xsn](#Section_cadcb03133274023952d6607c1ab634e) (section 2.3.6.1.2) | | http://schemas.microsoft.com/office/2006/metadata/contentType | [Schema for Content Type](#Section_5a76628af8624994a57eec37de5c6c78) (section 2.3.6.1.3) | | http://schemas.microsoft.com/office/2006/coverPageProps | [Cover Page Properties](#Section_1deeffdeda944ce78188af1ef5d29e67) (section 2.3.6.1.4) | | http://schemas.microsoft.com/office/2006/metadata/longProperties | [Long Properties](#Section_6ad9a50924ce46ffb28f77bcd3139b32) (section 2.3.6.1.5) | | office.server.policy | Collaborative Application Markup Language (CAML) Structure ([\[MS-WSSCAML\]](%5bMS-WSSCAML%5d.pdf#Section_8d6156fd646842949594644a946ed6a6) section 2.5.1.7) | ##### Custom Property Editor This section specifies the [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067) for the list and settings for any XSN files (as specified by InfoPath Form Template Format Structure Specification [\[MS-IPFF\]](%5bMS-IPFF%5d.pdf#Section_93482ffc8be24c288de5324a835e66b1)) that are associated with the document to edit information in its custom XML data items. ###### XMLNamespace Specifies the root namespace of custom XML data items that are appropriate for editing by the XSN specified in the [**XSNLocation**](#Section_47b70b8b19764430ade6b3f6adf2262f) element (section 2.3.6.1.1.2). **Parent element:** [**customPropertyEditor**](#Section_2169d00b14074f15abcab1ee8aa2a2a1) (section 2.3.6.1.1.5) \ ###### XSNLocation Specifies the path to the XSN file. **Parent element:** [**customPropertyEditor**](#Section_2169d00b14074f15abcab1ee8aa2a2a1) (section 2.3.6.1.1.5) \ ###### showOnOpen This element specifies whether to present a UI to edit either the core properties or properties in one of the custom XML data items in the document as specified by the [**defaultPropertyEditorNamespace**](#Section_b820dac0f2cf405f9da3912331ed527f) (section 2.3.6.1.1.4). A setting of "true" specifies that the editing UI is displayed. If set to any other value or not present, the editing UI is not presented. **Parent element:** [**customPropertyEditors**](#Section_67e2ad00a4b74887a5b5f96ec69765a9) (section 2.3.6.1.1.6) \ ###### defaultPropertyEditorNamespace This element specifies the [**XML namespace**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) that identifies the XSN to be shown by default when editing the properties contained in the custom XML data items of the document. **Parent element:** [**customPropertyEditors**](#Section_67e2ad00a4b74887a5b5f96ec69765a9) (section 2.3.6.1.1.6) \ ###### customPropertyEditor This element associates a namespace with the location of an XSN file (as specified by InfoPath Form Template Format Structure Specification [\[MS-IPFF\]](%5bMS-IPFF%5d.pdf#Section_93482ffc8be24c288de5324a835e66b1)). The [**XMLNamespace**](#Section_4eff429624e14042a785bc135c4d63df) (section 2.3.6.1.1.1) child specifies which custom XML data items are suitable for editing; the [**XSNLocation**](#Section_47b70b8b19764430ade6b3f6adf2262f) (section 2.3.6.1.1.2) child specifies a path to the XSN file. **Parent element:** [**customPropertyEditors**](#Section_67e2ad00a4b74887a5b5f96ec69765a9) (section 2.3.6.1.1.6) | Child elements | |----------------------------------------| | **XMLNamespace** (section 2.3.6.1.1.1) | | **XSNLocation** (section 2.3.6.1.1.2) | \ \ \ \ \ \ ###### customPropertyEditors This element specifies the list and settings for any XSN files (as specified by InfoPath Form Template Format Structure Specification [\[MS-IPFF\]](%5bMS-IPFF%5d.pdf#Section_93482ffc8be24c288de5324a835e66b1)) that are associated with the document to edit information in its custom XML data items. | Child elements | |----| | [**customPropertyEditor**](#Section_2169d00b14074f15abcab1ee8aa2a2a1) (section 2.3.6.1.1.5) | | [**defaultPropertyEditorNamespace**](#Section_b820dac0f2cf405f9da3912331ed527f) (section 2.3.6.1.1.4) | | [**showOnOpen**](#Section_b529581ef7d94e4086694155b82ca0d5) (section 2.3.6.1.1.3) | \ \ \ \ \ \ \ ##### Custom Xsn This section specifies the [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067) for specifying whether an XSN file (as specified by InfoPath Form Template Format Structure Specification [\[MS-IPFF\]](%5bMS-IPFF%5d.pdf#Section_93482ffc8be24c288de5324a835e66b1)) is presented for editing information in the custom XML data item with the namespace of http://schemas.microsoft.com/office/2006/metadata/properties in the document. ###### ST_TrueFalse This simple type specifies restriction for specifying the Boolean values. **False** : **false** **True** : **true** *Referenced by:* *[cached](#Section_47752cf7ea8b4994a685259f261254e7), [openByDefault](#Section_4feeb65bf49248b2bc25bd0155c9bf1f)* \ \ \ \ \ \ ###### xsnLocation This element specifies the location of an XSN file (as specified by InfoPath Form Template Format Structure Specification [\[MS-IPFF\]](%5bMS-IPFF%5d.pdf#Section_93482ffc8be24c288de5324a835e66b1)) to use for editing information in the custom XML data item with the namespace http://schemas.microsoft.com/office/2006/metadata/properties in the document. **Parent element:** [**customXsn**](#Section_ceb529d2572a46a7a8d33951e059de4f) (section 2.3.6.1.2.6) \ ###### cached This element specifies whether to use the XSN specified by the [**xsnLocation**](#Section_6a40521d8a294cc9b8590078594cd322) (section 2.3.6.1.2.2) for editing the information in the custom XML data item with the namespace http://schemas.microsoft.com/office/2006/metadata/properties in the document. If set to **false** the specified XSN MUST be used. If set to "True" the specified XSN MUST NOT be used. **Parent element:** [**customXsn**](#Section_ceb529d2572a46a7a8d33951e059de4f) (section 2.3.6.1.2.6) \ ###### openByDefault This element specifies whether to present UI to edit information in the custom XML data item with the namespace http://schemas.microsoft.com/office/2006/metadata/properties in the document, immediately after opening the same. A value of **true** specifies that the UI is shown by default. A value of **false** or the absence of the element specifies that the UI is not shown. **Parent element:** [**customXsn**](#Section_ceb529d2572a46a7a8d33951e059de4f) (section 2.3.6.1.2.6) \ ###### xsnScope Specifies the path to use for resolving any [**relative paths**](#gt_f0a8c9c7-1368-4989-addb-4792c3206387) that appear within the XSN specified by [**xsnLocation**](#Section_6a40521d8a294cc9b8590078594cd322) (section 2.3.6.1.2.2). **Parent element:** [**customXsn**](#Section_ceb529d2572a46a7a8d33951e059de4f) (section 2.3.6.1.2.6) \ ###### customXsn This element specifies whether an XSN file (as specified by InfoPath Form Template Format Structure Specification [\[MS-IPFF\]](%5bMS-IPFF%5d.pdf#Section_93482ffc8be24c288de5324a835e66b1)) is to be presented for editing information in the custom XML data item with the namespace of "http://schemas.microsoft.com/office/2006/metadata/properties" in the document. *Child elements:* [**cached**](#Section_47752cf7ea8b4994a685259f261254e7) (section 2.3.6.1.2.3) [**openByDefault**](#Section_4feeb65bf49248b2bc25bd0155c9bf1f) (section 2.3.6.1.2.4) [**xsnLocation**](#Section_6a40521d8a294cc9b8590078594cd322) (section 2.3.6.1.2.2) [**xsnScope**](#Section_b7a74aaeac8e4670987baac055ce7125) (section 2.3.6.1.2.5) \ \ \ \ \ \ \ \ ##### Schema for Content Type This section specifies the [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067) for the custom XML data item that specifies properties of the content type associated with the document. ###### ContentTypeId This simple type specifies restriction for specifying a content type identifier for a document. *Referenced by: [contentTypeSchema.SchemaForContentType@contentTypeID](#Section_708783bb2f0e4fa490372a952688f757)* \ \ \ \ \ \ \ ###### IntNonNegative This simple type specifies the restriction for specifying non-negative integers. *Referenced by:* *[contentTypeSchema.SchemaForContentType@contentTypeVersion](#Section_708783bb2f0e4fa490372a952688f757), [DummyContentTypeElement.DummyContentType@index](#Section_e1f362d7a9e543b387fafa73531ad4e2)* \ \ \ \ \ ###### UniqueIdentifierWithoutBraces This simple type specifies the restriction on the [**UniqueIdentifierWithoutBracesOrEmpty**](#Section_50ffad9914214f9e9e601b1bf1fedf28) (section 2.3.6.1.3.4) data type for specifying a [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1). *Referenced by:* [*DummyContentTypeElement.DummyContentType@web*](#Section_e1f362d7a9e543b387fafa73531ad4e2) \ \ \ \ \ ###### UniqueIdentifierWithoutBracesOrEmpty This simple type specifies the restrictions for specifying a [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) without braces or an empty string. *Referenced by:* [*DummyContentTypeElement.DummyContentType@web*](#Section_e1f362d7a9e543b387fafa73531ad4e2) \ \ \ \ \ \ ###### DummyContentTypeElement This specifies the child schema for the [**contentTypeSchema**](#Section_708783bb2f0e4fa490372a952688f757) (section 2.3.6.1.3.7). Attributes: **anchorId :** Specifies the term that parents all terms that can be selected as a valid value for the property corresponding to this **xsd:element**. If set to 00000000-0000-0000-0000-000000000000, specifies that all terms in the term set specified by the **termSetId** attribute MUST be treated as valid values for the property corresponding to this **xsd:element**. MUST be present on **xsd:elements** for which the **taxonomy** attribute is set to **true**. If applied to any other element, this attribute MUST be ignored. **decimals :** When applied to an **xsd:element** in a schema other than the root schema whose content model is an xsd:restriction based on {http://schemas.microsoft.com/office/2006/documentManagement/types}Currency or {http://schemas.microsoft.com/office/2006/documentManagement/types}Number, specifies the number of fractional digits to display in the property-editing UI for the property corresponding to this **xsd:element**. If applied to any other element, this attribute MUST be ignored. **default :** When applied to an xsd:element in a schema other than the root schema or the core schema, specifies the initial value of the property corresponding to this **xsd:element**. When applied to an xsd:element in a schema other than the root schema or core schema whose content model is an xsd:restriction based on {http://schemas.microsoft.com/office/2006/documentManagement/types}DateTime, if set to "\[today\]", specifies that the initial value of the property corresponding to this **xsd:element** MUST be set to the current [**UTC**](#gt_f2369991-a884-4843-a8fa-1505b6d5ece7) date and time. When applied to an xsd:element in a schema other than the root schema or core schema whose content model is an xsd:restriction based on {http://schemas.microsoft.com/office/2006/documentManagement/types}Boolean, the value of 1 is interpreted as logical **true** and all other values as logical **false** in determining the initial value of the property corresponding to this **xsd:element**. If applied to any other element, this attribute MUST be ignored. **description :** When applied to an xsd:element in a schema other than the root schema, specifies the description of the property corresponding to this xsd:element. If applied to any other element, this attribute MUST be ignored. **displayName :** When applied to an **xsd:element** in a schema other than the root schema or core schema, specifies the display name for the property corresponding to this xsd:element. If applied to any other element, this attribute MUST be ignored. **fieldId :** Specifies a unique identifier for the field. MUST be present on xsd:elements for which the **taxonomy** attribute is set to **true**. If applied to any other element, this attribute MUST be ignored. **fieldsID :** This attribute MUST be ignored. **format :** When applied to an **xsd:element** in a schema other than the root schema or core schema whose content model is an xsd:restriction based on {http://schemas.microsoft.com/office/2006/documentManagement/types}DateTime, if set to "DateTime" specifies that the property value corresponding to this **xsd:element** MUST include both the date and time, and if not present or set to any other value, specifies that the property value MUST include only the date. If applied to any other element, this attribute MUST be ignored. **hidden :** When applied to an xsd:element in a schema other than the root schema or core schema, if set to **true**, specifies that the property corresponding to this **xsd:element** MUST NOT be presented for editing. If applied to any other element, this attribute MUST be ignored. **index :** Specifies the ordering on the property-editing UI of **xsd:elements** bearing this attribute from schemas other than the root schema. First, the **xsd:elements** are broken into groups, as follows. The first group is composed of any **xsd:element** that is all of the following: - - - Is not the "description" element in the core properties.Is not a simpleType restriction based on {http://schemas.microsoft.com/office/2006/documentManagement/types}Note.Is not a complex content based on any of {http://schemas.microsoft.com/office/2006/documentManagement/types}MultiChoice, {http://schemas.microsoft.com/office/2006/documentManagement/types}MultiChoiceFillIn, or {http://schemas.microsoft.com/office/2006/documentManagement/types}MultiChoiceLookup.The second group is composed of the remaining xsd:elements bearing this attribute from schemas other than the root schema. The order within each group is the ascending order of the **index** attribute values. If an xsd:element in a schema other than the root schema or core schema does not have this attribute, it MUST NOT be presented for editing. If applied to any other element, this attribute MUST be ignored. **indexed :** When applied to an **xsd:element** for which neither the **hidden** nor **readOnly** attributes are set to **true** in a schema other than the root schema or core schema, if set to **true**, specifies that the property corresponding to **this xsd:element** MUST be presented for editing. If applied to any other element, this attribute MUST be ignored. **internalName :** Specifies an internal name for the xsd:element bearing this attribute. It MUST be present on **xsd:elements** in a schema other than the root schema or core schema. If applied to any other element, this attribute MUST be ignored. **isKeyword :** If set to **true**, specifies that the property-editing UI for the property corresponding to this xsd:element uses all available term stores and term sets. If set to **false**, specifies that the property-editing UI for the property corresponding to this xsd:element uses the term set specified by the **termSetId** attribute. MUST be present on xsd:elements for which the **taxonomy** attribute is set to **true**. If applied to any other element, this attribute MUST be ignored. **LCID :** When applied to an xsd:element in a schema other than the root schema or core schema whose content model is an xsd:restriction based on {http://schemas.microsoft.com/office/2006/documentManagement/types}Currency, specifies the [**locale**](#gt_7b78ebef-e35d-45ab-abfd-4121b60995de) identifier as specified in [\[MS-LCID\]](%5bMS-LCID%5d.pdf#Section_70feba9f294e491eb6eb56532684c37f) used to determine the currency symbol used in the display of the property corresponding to this xsd:element in the property-editing UI. If applied to any other element, this attribute MUST be ignored. **list :** Specifies the list to obtain data from, when displaying the property corresponding to this xsd:element in the property-editing UI. MUST be present on xsd:elements for which neither the **hidden** nor **readOnly** attributes are set to **true** in a schema other than the root schema or core schema whose content model is an xsd:restriction based on {http://schemas.microsoft.com/office/2006/documentManagement/types}Lookup or {http://schemas.microsoft.com/office/2006/documentManagement/types}MultiLookup. If applied to any other element, this attribute MUST be ignored. **open :** If set to **true**, specifies that new terms are allowed to be added to the term set specified by the **termSetId** attribute. If set to **false**, the property-editing UI MUST NOT allow new terms to be added to the term set specified by the **termSetId** attribute. MUST be present on xsd:elements for which the **taxonomy** attribute is set to **true**, and MUST be set to **true** if new terms are allowed to be added to the term set specified by the **termSetId** attribute. MUST be set to **false** otherwise. If applied to any other element, this attribute MUST be ignored. **percentage :** When applied to an **xsd:element** in a schema other than the root schema or core schema whose content model is an xsd:restriction based on {http://schemas.microsoft.com/office/2006/documentManagement/types}Currency or {http://schemas.microsoft.com/office/2006/documentManagement/types}Number, if set to **true**, specifies that the property corresponding to this xsd:element MUST be displayed as a percentage in the property-editing UI, and if not present or set to any other value, specifies that the property corresponding to this xsd:element MUST NOT be displayed as a percentage in the property-editing UI. If applied to any other element, this attribute MUST be ignored. **readOnly :** When applied to an **xsd:element** in a schema other than the root schema or core schema, if set to **true**, specifies that the property corresponding to this **xsd:element** MUST NOT be presented for editing. If applied to any other element, this attribute MUST be ignored. **requiredMultiChoice :** When applied to an **xsd:element** in a schema other than the root schema or core schema whose content model is an xsd:restriction based on {http://schemas.microsoft.com/office/2006/documentManagement/types}MultiChoice, {http://schemas.microsoft.com/office/2006/documentManagement/types}MultiChoiceFillIn, or {http://schemas.microsoft.com/office/2006/documentManagement/types}MultiChoiceLookup, if set to "true", choices MUST be selected for the property corresponding to this **xsd:element**. If applied to any other element, this attribute MUST be ignored. **root :** MUST be set to **true** on the root schema element specified in the **contentTypeSchema** (section 2.3.6.1.3.7). It MUST NOT be applied to any other element. **showField :** Specifies the text displayed in the property-editing UI for the lookup options of the property corresponding to this **xsd:element**. MUST be present on **xsd:elements** for which neither the **hidden** nor **readOnly** attributes are set to **true** in a schema other than the root schema or core schema whose content model is an **xsd:restriction** based on {http://schemas.microsoft.com/office/2006/documentManagement/types}Lookup or {http://schemas.microsoft.com/office/2006/documentManagement/types}MultiLookup. If applied to any other element, this attribute MUST be ignored. **sspId :** Specifies the term store identifier used in the property-editing UI for the property corresponding to this **xsd:element**. MUST be present on **xsd:elements** for which the **taxonomy** attribute is set to **true**, and MUST be set to 00000000-0000-0000-0000-000000000000 on **xsd:elements** for which the **isKeyword** attribute is set to **true**. If applied to any other element, this attribute MUST be ignored. **taxonomy :** MUST be set to **true** on **xsd:elements** in a schema other than the root schema or core schema whose content model has the following structure. 204. \ \ \ \ \ \ It MUST NOT be applied to any other element. **taxonomyFieldName :** MUST be present on **xsd:elements** for which the **taxonomy** attribute is set to **true**. If applied to any other element, this attribute MUST be ignored. **taxonomyMulti :** If set to **false**, specifies that only single values are displayed as valid in the property-editing UI for the property corresponding to this **xsd:element**. MUST be present on **xsd:elements** for which the **taxonomy** attribute is set to **true**. If applied to any other element, this attribute MUST be ignored. **termSetId :** Specifies the term set used in the property-editing UI for the property corresponding to this xsd:element. MUST be present on xsd:elements for which the **taxonomy** attribute is set to "true", and MUST be set to 00000000-0000-0000-0000-000000000000 on **xsd:elements** for which the **isKeyword** attribute is set to **true**. If applied to any other element, this attribute MUST be ignored. **web :** When applied to an **xsd:element** for which neither the **hidden** nor **readOnly** attributes are set to **true** in a schema other than the root schema or core schema whose content model is an xsd:restriction based on {http://schemas.microsoft.com/office/2006/documentManagement/types}Lookup or {http://schemas.microsoft.com/office/2006/documentManagement/types}MultiLookup, specifies the location of the website containing the list from which data is obtained to display the property corresponding to this xsd:element in the property-editing UI. If applied to any other element, this attribute MUST be ignored. \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ ###### schema This element specifies an [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067). **Parent element:** [**contentTypeSchema**](#Section_708783bb2f0e4fa490372a952688f757) (section 2.3.6.1.3.7) \ ###### contentTypeSchema The attributes and child elements of this element collectively specify a schema for the custom XML data item that specifies properties of the content type associated with the document. Each child of this element is an [**xsd:schema**](#Section_a19e7eeb1ab54d64bcc9dff9a6399ba4) (section 2.3.6.1.3.6) element (as specified by [\[W3C-XSD\]](https://go.microsoft.com/fwlink/?LinkId=90563)) that specifies one or more elements that appear in the custom XML data item. These xsd:schema elements are decorated with attributes from the http://schemas.microsoft.com/office/2006/metadata/properties/metaAttributes namespace as specified in section [2.3.6.1.3.5](#Section_e1f362d7a9e543b387fafa73531ad4e2). This element MUST contain an xsd:schema child element that has the **ma:root** Root (**DummyContentTypeElement.DummyContentType@root** (section 2.3.6.1.3.5)) attribute with value **true**. This **xsd:schema** specifies the structure of the root element of this Custom XML Data Storage item. This **xsd:schema** MUST have its **targetNamespace** attribute set to http://schemas.microsoft.com/office/2006/metadata/properties. It MUST declare and import any namespaces used by its child elements that are specified by other **xsd:schema** child elements. This xsd:schema element MUST have a **ma:fieldsID** Field IDs Hash (**DummyContentTypeElement.DummyContentType@fieldsID** (section 2.3.6.1.3.5)) attribute. Additionally, this **xsd:schema** element MUST declare an element called **properties** with the following structure. The child elements of the **xsd:all** are not shown, but are instead specified following this XML markup. 210. \ \ \ \ \ \ ... \ \ \ \ \ \ In the following description, the term "content type" refers specifically to the root element of the Content Type Definition Type as specified in Collaborative Application Markup Language (CAML) Structure ([\[MS-WSSCAML\]](%5bMS-WSSCAML%5d.pdf#Section_8d6156fd646842949594644a946ed6a6) section 2.4.1.1). Let the term "fields" denote the list of all Field elements that are the fields used in the content type, as specified in Collaborative Application Markup Language (CAML) Structure (\[MS-WSSCAML\] section 2.3.2.6). Furthermore, let the term "filtered fields" denote the list of all filtered fields to be those Field elements from the fields that satisfy all of the following conditions (the quotes are not included): - - - The value of the **Type** attribute is not "Computed", "Calculated", "WorkflowStatus", "TaxonomyFieldType", or "TaxonomyFieldTypeMulti".The value of the **Name** attribute is not "Modified_x0020_By", "Created_x0020_By", "Modified", "Created", or "FileLeafRef".The value of the **StaticName** attribute is not "Title", "Subject", "\_Author", "Keywords", "\_Comments", "\_Category", "Slides", "ContentType", or "Status".The xsd:all element from the structure described previously MUST contain an xsd:element element for each Field element in the filtered fields set. This xsd:element MUST have a **ref** attribute. The value of the **ref** attribute MUST be a qualified reference to a type whose name is the value of the **StaticName** attribute of the Field element, and which resides in the namespace identified by the **SourceID** attribute of the Field element. Furthermore, if the **Required** attribute is not present on the Field element, or if the attribute is present but its value is not **true**, or if the value of the **Type** attribute is "MultiChoice" or "LookupMulti", then a **minOccurs** attribute with value of 0 MUST be present on the xsd:element element. For each unique string that appears as the value of the **SourceID** attributes on any Field element in fields, the contentTypeSchema element MUST contain an xsd:schema child whose **targetNamespace** attribute has that same value. Each **xsd:schema** MUST contain one xsd:element element for each Field whose **SourceID** attribute is the same as the **targetNamespace** of the xsd:schema. Each xsd:element element MUST have a **Name** attribute whose value is the value of the **StaticName** attribute on the corresponding Field element. Each **xsd:element** element MUST have a **ma:index** Index (**DummyContentTypeElement.DummyContentType@index** (section 2.3.6.1.3.5)) attribute whose value is the number of Field elements that appear before the corresponding Field element within the Fields element in the content type. If the **Required** attribute is not present on the corresponding Field element, or if the attribute is present but its value is not **true**, or if the value of the **Type** attribute is "MultiChoice" or "LookupMulti", a **nullable** attribute (\[W3C-XSD\]) with value of **true** MUST be present on the **xsd:element** element. The following attributes can appear on each **xsd:element** element: - - - - - - - - - - - - - **ma:displayName** Display Name (**DummyContentTypeElement.DummyContentType@displayName** (section 2.3.6.1.3.5))**ma:decimals** Decimals (**DummyContentTypeElement.DummyContentType@decimals** (section 2.3.6.1.3.5))**ma:default** Default (**DummyContentTypeElement.DummyContentType@default** (section 2.3.6.1.3.5))**ma:description** Description (**DummyContentTypeElement.DummyContentType@description** (section 2.3.6.1.3.5)); **ma:format** Format (**DummyContentTypeElement.DummyContentType@format** (section 2.3.6.1.3.5))**ma:hidden** Hidden (**DummyContentTypeElement.DummyContentType@hidden** (section 2.3.6.1.3.5))**ma:LCID** LCID (**DummyContentTypeElement.DummyContentType@LCID** (section 2.3.6.1.3.5))**ma:list** List (**DummyContentTypeElement.DummyContentType@list** (section 2.3.6.1.3.5))**ma:internalName** Internal Name (**DummyContentTypeElement.DummyContentType@internalName** (section 2.3.6.1.3.5))**ma:readOnly** Read Only (**DummyContentTypeElement.DummyContentType@readOnly** (section 2.3.6.1.3.5))**ma:showField** Show Field (**DummyContentTypeElement.DummyContentType@showField** (section 2.3.6.1.3.5))**ma:percentage** Percentage (**DummyContentTypeElement.DummyContentType@percentage** (section 2.3.6.1.3.5))**ma:web** Web (**DummyContentTypeElement.DummyContentType@web** (section 2.3.6.1.3.5))**ma:requiredMultiChoice** Required Multiple Choice (**DummyContentTypeElement.DummyContentType@requiredMultiChoice** (section 2.3.6.1.3.5))The **contentTypeSchema** MUST have an **xsd:schema** child element whose **targetNamespace** attribute has the value "http://schemas.openxmlformats.org/package/2006/metadata/core-properties". **Child element:** **schema** (section 2.3.6.1.3.6) Attributes: **contentTypeDescription :** MUST be the same value as the **Description** attribute of the ContentType element (as specified in Collaborative Application Markup Language (CAML) Structure (\[MS-WSSCAML\] section 2.4.1.1) for the content type associated with the document. **contentTypeID :** Identifies the content type associated with the document. **contentTypeName :** MUST be the same value as the **Name** attribute of the ContentType element as specified in Collaborative Application Markup Language (CAML) Structure (\[MS-WSSCAML\] section 2.4.1.1) for the content type associated with the document. **contentTypeScope :** MUST be empty and MUST be ignored. **contentTypeVersion :** MUST be the same value as the **Version** attribute of the ContentType element as specified in Collaborative Application Markup Language (CAML) Structure (\[MS-WSSCAML\] section 2.4.1.1) for the content type associated with the document. **versionID :** Specifies the string hash used to determine if the definition of the content type associated with the document has changed since the last time the content type was applied to the document. The value MUST be computed as an MD5 hash (as specified in [\[RFC1321\]](https://go.microsoft.com/fwlink/?LinkId=90275)) of the substring that represents the **ContentType** element (beginning with "\", both strings included) within the SOAP result of the **GetListContentType** web service request ([\[MS-LISTSWS\]](%5bMS-LISTSWS%5d.pdf#Section_30b364cc38374e839ce81963292e2ee5) section 3.1.4.17). \ \ \ \ \ \ \ \ \ \ \ ##### Cover Page Properties This section specifies the [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067) for specifying properties used for the document cover page[\<73\>](#Appendix_A_73). ###### ST_PublishDate This simple type specifies the document publish date. \ \ \ ###### PublishDate Specifies the date the document was published. **Parent element:** [**CoverPageProperties**](#Section_252c6032cf674f6c91d65f56ea66c7da) (section 2.3.6.1.4.8) \ ###### Abstract Specifies the abstract of the document’s content. **Parent element:** [**CoverPageProperties**](#Section_252c6032cf674f6c91d65f56ea66c7da) (section 2.3.6.1.4.8) \ ###### CompanyAddress Specifies the address of the company to be used in the document. **Parent element:** [**CoverPageProperties**](#Section_252c6032cf674f6c91d65f56ea66c7da) (section 2.3.6.1.4.8) \ ###### CompanyPhone Specifies the phone number of the company to be used in the document. **Parent element:** [**CoverPageProperties**](#Section_252c6032cf674f6c91d65f56ea66c7da) (section 2.3.6.1.4.8) \ ###### CompanyFax Specifies the fax number of the company to be used in the document. **Parent element:** [**CoverPageProperties**](#Section_252c6032cf674f6c91d65f56ea66c7da) (section 2.3.6.1.4.8) \ ###### CompanyEmail Specifies the email address of the company to be used in the document. **Parent element:** [**CoverPageProperties**](#Section_252c6032cf674f6c91d65f56ea66c7da) (section 2.3.6.1.4.8) \ ###### CoverPageProperties Specifies the parent element for properties used for the document cover page. *Child elements:* [**Abstract**](#Section_df05d7588d6647b4bbff5a7f11ae446c) (section 2.3.6.1.4.3) [**CompanyAddress**](#Section_c09e991e764a40748c201214c6634a48) (section 2.3.6.1.4.4) [**CompanyEmail**](#Section_e212a2749e464501afa1d4cf1f7f1256) (section 2.3.6.1.4.7) [**CompanyFax**](#Section_eb00ac2c2e4447f9a150dee3880a2947) (section 2.3.6.1.4.6) [**CompanyPhone**](#Section_5a6b2056449a4ad4935ee114c8cf1218) (section 2.3.6.1.4.5) [**PublishDate**](#Section_9dccbce275e24276a0bbf066c67dbbae) (section 2.3.6.1.4.2) \ \ \ \ \ \ \ \ \ \ ##### Long Properties This section specifies the [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067) for specifying the full content of the [User Defined Properties](#Section_54514afbff194348be71395854d4432d) (section 2.3.3.2.3) whose values exceed 255 characters. ###### LongProp This element specifies the full value of a user-defined property that exceeds 255 characters. **Parent element:** [**LongProperties**](#Section_3e0d6857c12443a6a14493ee50a79e44) (section 2.3.6.1.5.2) Attributes: **name :** Specifies the name of the user-defined property. \ \ \ \ \ \ \ \ \ ###### LongProperties This element specifies the full content of user defined properties whose values exceed 255 characters. **Child element:** [**LongProp**](#Section_8ed57b888c0841dba4a93471853de759) (section 2.3.6.1.5.1) \ \ \ \ \ \ \ \ \ \ \ \ \ #### Custom XML Data Storage Properties The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "Properties". An instance of this stream contains an XML fragment conforming to the namespace http://schemas.openxmlformats.org/officeDocument/2006/customXml. It contains the set of properties which are specified for the corresponding custom XML data item. These properties consist of a unique ID for the custom XML data item and information about the set of [**XML schemas**](#gt_bd0ce6f9-c350-4900-827e-951265294067) used by the custom XML data item. ##### ST_Guid This simple type specifies the restriction for specifying a [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1). *Referenced by:* [*datastoreItem.CustomXmlDataProperties@itemID*](#Section_a8fb433020724dd8962bfc57e7dfc5dd) \ \ \ \ \ ##### schemaRef This element specifies a single [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067) that is associated with the custom XML data item. This XML schema is identified using its target namespace. **Parent element:** [**schemaRefs**](#Section_40b3b0b5243e4f6f8e645f446fb70ac2) (section 2.3.6.2.3) Attributes: **uri :** Specifies the target namespace for the XML Schema associated with this schema reference. \ \ \ ##### schemaRefs This element specifies the set of [**XML schemas**](#gt_bd0ce6f9-c350-4900-827e-951265294067) that are associated with the corresponding custom XML data item. If this element is present, then the set of XML schemas provided within MUST be used to validate the contents of the corresponding custom XML data item. If no child [**schemaRef**](#Section_9cb777251f9c465bb7e880ef27929002) (section 2.3.6.2.2) elements exist then XML schema validation MUST NOT be performed on the custom XML data item. **Parent element:** [**datastoreItem**](#Section_a8fb433020724dd8962bfc57e7dfc5dd) (section 2.3.6.2.4) **Child element:** **schemaRef** (section 2.3.6.2.2) \ \ \ \ \ ##### dataStoreItem This element specifies the properties for the corresponding custom XML data item. The set of properties specified within this element is attached to the custom XML data item. **Child element:** [**schemaRefs**](#Section_40b3b0b5243e4f6f8e645f446fb70ac2) (section 2.3.6.2.3) Attributes: **itemID :** Specifies a [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) that uniquely identifies a single custom XML data item within the document. Each **itemID** value MUST be unique among all custom XML data items in the document. \ \ \ \ \ \ ### Hyperlinks This section specifies [**hyperlink**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e)-related objects. #### Hyperlink Object This structure specifies a [**hyperlink**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) and hyperlink-related information. [TABLE] **streamVersion (4 bytes):** An unsigned integer that specifies the version number of the serialization implementation used to save this structure. This value MUST equal 2. **A - hlstmfHasMoniker (1 bit):** A bit that specifies whether this structure contains a [**moniker**](#gt_b88df1f8-e55a-4d08-9861-e7d6a4ed9abc). If **hlstmfMonikerSavedAsStr** equals 1, this value MUST equal 1. **B - hlstmfIsAbsolute (1 bit):** A bit that specifies whether this hyperlink is an [**absolute path**](#gt_e2edaf4f-a7f6-463e-9fe5-9b8bd3ce83c6) or [**relative path**](#gt_f0a8c9c7-1368-4989-addb-4792c3206387). | **Value** | **Meaning** | |-----------|-------------------------------------| | 0 | This hyperlink is a relative path. | | 1 | This hyperlink is an absolute path. | **C - hlstmfSiteGaveDisplayName (1 bit):** A bit that specifies whether the creator of the hyperlink specified a display name. **D - hlstmfHasLocationStr (1 bit):** A bit that specifies whether this structure contains a [**hyperlink location**](#gt_8b9cd56d-fa77-4360-a03f-9a2d5b5e0ff9). **E - hlstmfHasDisplayName (1 bit):** A bit that specifies whether this structure contains a display name. **F - hlstmfHasGUID (1 bit):** A bit that specifies whether this structure contains a [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2). **G - hlstmfHasCreationTime (1 bit):** A bit that specifies whether this structure contains the creation time of the file that contains the hyperlink. **H - hlstmfHasFrameName (1 bit):** A bit that specifies whether this structure contains a [**target frame**](#gt_1553572d-5903-4ce6-b842-fcfe103d72e8) name. **I - hlstmfMonikerSavedAsStr (1 bit):** A bit that specifies whether the moniker was saved as a string. **J - hlstmfAbsFromGetdataRel (1 bit):** A bit that specifies whether the hyperlink specified by this structure is an absolute path generated from a relative path. **reserved (22 bits):** MUST be zero and MUST be ignored. **displayName (variable):** An optional [**HyperlinkString**](#Section_1a9f6231df634a95b9985c2b95b82965) (section 2.3.7.9) that specifies the display name for the hyperlink. MUST exist if and only if **hlstmfHasDisplayName** equals 1. **targetFrameName (variable):** An optional **HyperlinkString** (section 2.3.7.9) that specifies the target frame. MUST exist if and only if **hlstmfHasFrameName** equals 1. **moniker (variable):** An optional **HyperlinkString** (section 2.3.7.9) that specifies the hyperlink moniker. MUST exist if and only if **hlstmfHasMoniker** equals 1 and **hlstmfMonikerSavedAsStr** equals 1. **oleMoniker (variable):** An optional [**HyperlinkMoniker**](#Section_0cc5cf392a1645a9a7fb8994ce3f01a5) (section 2.3.7.2) that specifies the hyperlink moniker. MUST exist if and only if **hlstmfHasMoniker** equals 1 and **hlstmfMonikerSavedAsStr** equals 0. **location (variable):** An optional **HyperlinkString** (section 2.3.7.9) that specifies the hyperlink location. MUST exist if and only if **hlstmfHasLocationStr** equals 1. **guid (16 bytes):** An optional GUID as specified by \[MS-DTYP\] that identifies this hyperlink. MUST exist if and only if **hlstmfHasGUID** equals 1. **fileTime (8 bytes):** An optional **FileTime** structure as specified by \[MS-DTYP\] that specifies the [**UTC**](#gt_f2369991-a884-4843-a8fa-1505b6d5ece7) file creation time. MUST exist if and only if **hlstmfHasCreationTime** equals 1. #### HyperlinkMoniker *Referenced by: [CompositeMoniker](#Section_b5e2deb030694bacbc749433311f691b), [Hyperlink Object](#Section_c04372224868466081f86b7ee236d3f8)* This structure specifies a [**hyperlink**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) [**moniker**](#gt_b88df1f8-e55a-4d08-9861-e7d6a4ed9abc). [TABLE] **monikerClsid (16 bytes):** A [**class identifier (CLSID)**](#gt_e433c806-6cb6-46a2-bb95-523df8818c99) that specifies the [**Component Object Model (COM)**](#gt_ef2ebebc-1760-407a-9ace-af48f9050e02) component that saved this structure. MUST be a value from the following table: | **Value** | **Meaning** | |----|----| | {0x79EAC9E0, 0xBAF9, 0x11CE, 0x8C, 0x82, 0x00, 0xAA, 0x00, 0x4B, 0xA9, 0x0B} | **Data** field contains a [**URLMoniker**](#Section_4948a119c4e446b696090525118552e8) (section 2.3.7.6). | | {0x00000303, 0x0000, 0x0000, 0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46} | **Data** field contains a [**FileMoniker**](#Section_c28c62d7adc5405585dbd957069965ac) (section 2.3.7.8). | | {0x00000309, 0x0000, 0x0000, 0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46} | **Data** field contains a **CompositeMoniker** (section 2.3.7.3). | | {0x00000305, 0x0000, 0x0000, { 0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46 } | **Data** field contains an [**AntiMoniker**](#Section_e56f55e7320d45beb5463250dd314f82) (section 2.3.7.4). | | {0x00000304, 0x0000, 0x0000, { 0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46 } | **Data** field contains an [**ItemMoniker**](#Section_fae1319fa20942b4b60fb2bb25cdc22c) (section 2.3.7.5). | **data (variable):** A moniker of the type specified by **monikerClsid**. #### CompositeMoniker *Referenced by: [HyperlinkMoniker](#Section_0cc5cf392a1645a9a7fb8994ce3f01a5)* This structure specifies a [**composite moniker**](#gt_1a7bac3d-446c-4dea-8e0f-6f08e8af465a). A composite moniker is a collection of arbitrary [**monikers**](#gt_b88df1f8-e55a-4d08-9861-e7d6a4ed9abc). For more information about composite monikers see [\[MSDN-IMGCMI\]](https://go.microsoft.com/fwlink/?LinkId=121363). [TABLE] **cMonikers (4 bytes):** An unsigned integer that specifies the count of monikers in **monikerArray**. **monikerArray (variable):** An array of **HyperlinkMonikers** (section 2.3.7.2). Each array element specifies a moniker of arbitrary type. #### AntiMoniker *Referenced by: [HyperlinkMoniker](#Section_0cc5cf392a1645a9a7fb8994ce3f01a5)* This structure specifies an [**anti-moniker**](#gt_80b938ff-5999-4c83-a1f2-2819a024136e). An anti-moniker acts as the inverse of any moniker it is composed onto, effectively canceling out that moniker. In a [**composite moniker**](#gt_1a7bac3d-446c-4dea-8e0f-6f08e8af465a), anti-monikers are used to cancel out existing moniker elements, because monikers cannot be removed from a composite moniker. For more information about anti-monikers, see [\[MSDN-IMAMI\]](https://go.microsoft.com/fwlink/?LinkId=121364). [TABLE] **count (4 bytes):** An unsigned integer that specifies the number of anti-monikers that have been composed together to create this instance. When an anti-moniker is composed with another anti-moniker, the resulting composition would have a **count** field equaling the sum of the two **count** fields of the composed anti-monikers. This value MUST be less than or equal to 1048576. #### ItemMoniker *Referenced by: [HyperlinkMoniker](#Section_0cc5cf392a1645a9a7fb8994ce3f01a5)* This structure specifies an [**item moniker**](#gt_df3f9a0a-d0f0-46f5-912c-2450a4f5f980). Item monikers are used to identify objects within containers, such as a portion of a document, an embedded object within a compound document, or a range of cells within a spreadsheet. For more information about item monikers, see [\[MSDN-IMCOM\]](https://go.microsoft.com/fwlink/?LinkId=121361). [TABLE] **delimiterLength (4 bytes):** An unsigned integer that specifies the sum of the count of bytes in the **delimiterAnsi** and **delimiterUnicode** fields. **delimiterAnsi (variable):** A null-terminated array of ANSI characters that specifies a delimiter for this [**moniker**](#gt_b88df1f8-e55a-4d08-9861-e7d6a4ed9abc). Delimiters are used to separate monikers that are part of a collection of monikers in a [**composite moniker**](#gt_1a7bac3d-446c-4dea-8e0f-6f08e8af465a). The number of characters in the array is determined by the position of the terminating NULL character. **delimiterUnicode (variable):** An optional array of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters that specifies a delimiter for this moniker if the delimiter cannot be completely specified in ANSI characters. This field MUST exist if and only if **delimiterLength** is greater than the size of **delimiterAnsi** in bytes. The number of characters in the array is determined by (delimiterLength - (size of delimiterAnsi in bytes)) / 2. **itemLength (4 bytes):** An unsigned integer that specifies the count of bytes in the **itemAnsi** and **itemUnicode** fields. **itemAnsi (variable):** A null-terminated array of ANSI characters that specifies the string used to identify this item in a collection of items. The number of characters in this array is specified by **itemLength**. **itemUnicode (variable):** An optional array of Unicode characters that specifies the string used to identify this item in a collection of items, if the string cannot be completely specified in ANSI characters. This field MUST exist if and only if **itemLength** is greater than the size of **itemAnsi** in bytes. The number of characters in the array is determined by (itemLength – (size of itemAnsi field in bytes)) / 2. #### URLMoniker *Referenced by: [HyperlinkMoniker](#Section_0cc5cf392a1645a9a7fb8994ce3f01a5)* This structure specifies a [**URL moniker**](#gt_756cc735-43ee-42b1-aa17-7652c51f9164). For more information about URL monikers, see [\[MSDN-URLM\]](https://go.microsoft.com/fwlink/?LinkId=121360). [TABLE] **length (4 bytes):** An unsigned integer that specifies the size of this structure in bytes, excluding the size of the **length** field. The value of this field MUST be either the byte size of the **url** field (including the terminating NULL character) or the byte size of the **url** field plus 24. If the value of this field is set to the byte size of the **url** field, then the **serialGUID**, **serialVersion**, and **uriFlags** fields MUST NOT be present. If the value of this field is set to the byte size of the **url** field plus 24, then the **serialGUID**, **serialVersion**, and **uriFlags** fields MUST be present. **url (variable):** A null-terminated array of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters that specifies the [**URL**](#gt_433a4fb7-ef84-46b0-ab65-905f5e3a80b1). The number of characters in the array is determined by the position of the terminating NULL character. **serialGUID (16 bytes):** An optional [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) for this implementation of the URL moniker serialization. This field MUST equal {0xF4815879, 0x1D3B, 0x487F, 0xAF, 0x2C, 0x82, 0x5D, 0xC4, 0x85, 0x27, 0x63} if present. **serialVersion (4 bytes):** An optional unsigned integer that specifies the version number of this implementation of the URL moniker serialization. This field MUST equal 0 if present. **uriFlags (4 bytes):** An optional [**URICreateFlags**](#Section_1786df8eb7924a28b7c54d9a91d2e401) structure (section 2.3.7.7) that specifies creation flags for an [\[RFC3986\]](https://go.microsoft.com/fwlink/?LinkId=90453) compliant URI. #### URICreateFlags *Referenced by: [URLMoniker](#Section_4948a119c4e446b696090525118552e8)* This structure specifies creation flags for an [\[RFC3986\]](https://go.microsoft.com/fwlink/?LinkId=90453) compliant [**URI**](#gt_e18af8e8-01d7-4f91-8a1e-0fb21b191f95). For more information about URI creation flags, see [\[MSDN-CreateUri\]](https://go.microsoft.com/fwlink/?LinkId=120601). [TABLE] **A - createAllowRelative (1 bit):** A bit that specifies that if the [**URI scheme**](#gt_f5d40fa3-8fb6-4644-a8cf-2df732d2f7cf) is unspecified and not implicitly "file," a relative scheme is assumed during creation of the URI. **B - createAllowImplicitWildcardScheme (1 bit):** A bit that specifies that if the URI scheme is unspecified and not implicitly "file," a wildcard scheme is assumed during creation of the URI. **C - createAllowImplicitFileScheme (1 bit):** A bit that specifies that if the URI scheme is unspecified and the URI begins with a drive letter or a [**UNC**](#gt_c9507dca-291d-4fd6-9cba-a9ee7da8c908) path, a file scheme is assumed during creation of the URI. **D - createNoFrag (1 bit):** A bit that specifies that if a [**URI query**](#gt_5fc09267-f219-4b37-9d55-606f96ada4c0) string is present, the [**URI fragment**](#gt_f19ecb2f-edbb-4bdf-b601-23119d7dccf4) is not looked for during creation of the URI. **E - createNoCanonicalize (1 bit):** A bit that specifies that the scheme, host, authority, path, and fragment will not be canonicalized during creation of the URI. This value MUST be 0 if **createCanonicalize** equals 1. **F - createCanonicalize (1 bit):** A bit that specifies that the scheme, host, authority, path, and fragment will be canonicalized during creation of the URI. This value MUST be 0 if **createNoCanonicalize** equals 1. **G - createFileUseDosPath (1 bit):** A bit that specifies that [**MS-DOS path compatibility mode**](#gt_f685c67b-3b1b-4c3c-be3a-5041756627f3) will be used during creation of file URIs. **H - createDecodeExtraInfo (1 bit):** A bit that specifies that percent encoding and percent decoding canonicalizations will be performed on the URI query and URI fragment during creation of the URI. This field takes precedence over the **createNoCanonicalize** field. This value MUST be 0 if **createNoDecodeExtraInfo** equals 1. The value 1 can also be saved. This will cause a return value of E_INVALIDARG from CreateUri(). **I - createNoDecodeExtraInfo (1 bit):** A bit that specifies that percent encoding and percent decoding canonicalizations will not be performed on the URI query and URI fragment during creation of the URI. This field takes precedence over the **createCanonicalize** field. This value MUST be 0 if **createDecodeExtraInfo** equals 1. The value 1 can also be saved. This will cause a return value of E_INVALIDARG from CreateUri(). **J - createCrackUnknownSchemes (1 bit):** A bit that specifies that hierarchical URIs with unrecognized URI schemes will be treated like hierarchical URIs during creation of the URI. This value MUST be 0 if **createNoCrackUnknownSchemes** equals 1. **K - createNoCrackUnknownSchemes (1 bit):** A bit that specifies that hierarchical URIs with unrecognized URI schemes will be treated like opaque URIs during creation of the URI. This value MUST be 0 if **createCrackUnknownSchemes** equals 1. **L - createPreProcessHtmlUri (1 bit):** A bit that specifies that preprocessing will be performed on the URI to remove control characters and white space during creation of the URI. This value MUST be 0 if **createNoPreProcessHtmlUri** equals 1. **M - createNoPreProcessHtmlUri (1 bit):** A bit that specifies that preprocessing will not be performed on the URI to remove control characters and white space during creation of the URI. This value MUST be 0 if **createPreProcessHtmlUri** equals 1. **N - createIESettings (1 bit):** A bit that specifies that registry settings will be used to determine default [**URL**](#gt_433a4fb7-ef84-46b0-ab65-905f5e3a80b1) parsing behavior during creation of the URI. This value MUST be 0 if **createNoIESettings** equals 1. **O - createNoIESettings (1 bit):** A bit that specifies that registry settings will not be used to determine default URL parsing behavior during creation of the URI. This value MUST be 0 if **createIESettings** equals 1. **P - createNoEncodeForbiddenCharacters (1 bit):** A bit that specifies that URI characters forbidden in \[RFC3986\] will not be percent-encoded during creation of the URI. **reserved (16 bits):** MUST be zero and MUST be ignored. #### FileMoniker *Referenced by: [HyperlinkMoniker](#Section_0cc5cf392a1645a9a7fb8994ce3f01a5)* This structure specifies a [**file moniker**](#gt_1817f7bc-637d-4bcf-8f7a-27e96f1e7e07). For more information about file monikers, see [\[MSDN-FM\]](https://go.microsoft.com/fwlink/?LinkId=121362). [TABLE] **cAnti (2 bytes):** An unsigned integer that specifies the number of [**parent directory indicators**](#gt_368cbdb8-5432-442d-9565-59193bad0d29) at the beginning of the **ansiPath** field. **ansiLength (4 bytes):** An unsigned integer that specifies the number of ANSI characters in **ansiPath**, including the terminating NULL character. This value MUST be less than or equal to 32767. **ansiPath (variable):** A null-terminated array of ANSI characters that specifies the file path. The number of characters in the array is specified by **ansiLength**. **endServer (2 bytes):** An unsigned integer that specifies the number of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters used to specify the server portion of the path if the path is a [**UNC**](#gt_c9507dca-291d-4fd6-9cba-a9ee7da8c908) path (including the leading "\\"). If the path is not a UNC path, this field MUST equal 0xFFFF. **versionNumber (2 bytes):** An unsigned integer that specifies the version number of this file moniker serialization implementation. MUST equal 0xDEAD. **reserved1 (16 bytes):** MUST be zero and MUST be ignored. **reserved2 (4 bytes):** MUST be zero and MUST be ignored. **cbUnicodePathSize (4 bytes):** An unsigned integer that specifies the size, in bytes, of **cbUnicodePathBytes**, **usKeyValue**, and **unicodePath**. If the file path specified in **ansiPath** cannot be completely specified by ANSI characters, the value of this field MUST be equal to the size, in bytes, of the path as a Unicode string (without a terminating NULL character) + 6. If the path can be fully specified in ANSI characters then the value of this field MUST be set to zero. If the value of this field is greater than zero, then the **cbUnicodePathBytes, usKeyValue** and **unicodePath** fields MUST exist. If the value of this field is zero, then the **cbUnicodePathBytes**, **usKeyValue**, and **unicodePath** fields MUST NOT exist. **cbUnicodePathBytes (4 bytes):** An optional unsigned integer that specifies the size, in bytes, of the **unicodePath** field. This field exists if and only if **cbUnicodePathSize** is greater than zero. **usKeyValue (2 bytes):** An optional unsigned integer that MUST be 3 if present. This field exists if and only if **cbUnicodePathSize** is greater than zero. **unicodePath (variable):** An optional array of Unicode characters that specifies the complete file path. This path MUST be the complete Unicode version of the file path specified in **ansiPath** and MUST include additional Unicode characters that cannot be completely specified in ANSI characters. The number of characters in this array is specified by **cbUnicodePathBytes**/2. This array MUST NOT include a terminating NULL character. This field exists if and only if **cbUnicodePathSize** is greater than zero. #### HyperlinkString *Referenced by: [Hyperlink Object](#Section_c04372224868466081f86b7ee236d3f8)* This structure specifies a string for a [**hyperlink**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e). [TABLE] **length (4 bytes):** An unsigned integer that specifies the number of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters in the **string** field, including the null-terminating character. **string (variable):** A null-terminated array of Unicode characters. The number of characters in the array is specified by the **length** field. ### MsoEnvelope This section specifies structures related to the [**MsoEnvelope**](#Section_52f153930e4f4bd9a521dcb8f0a869ef) structure (section 2.3.8.2). #### MsoEnvelopeCLSID A structure that specifies the type of data in **EnvelopeData** based on the value of [**CLSID**](#gt_e433c806-6cb6-46a2-bb95-523df8818c99). [TABLE] **CLSID (16 bytes):** A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1), as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2), that specifies the type of data in **EnvelopeData**. If this GUID equals { 0x0006F01A, 0x0000, 0x0000, { 0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46 } }, then the data in **EnvelopeData** is specified by [**MsoEnvelope**](#Section_52f153930e4f4bd9a521dcb8f0a869ef) structure (section 2.3.8.2). If not, then the data in **EnvelopeData** is out of scope for this document. **EnvelopeData (variable):** An array of bytes that is either specified by **MsoEnvelope** structure (section 2.3.8.2) or is out of scope, depending on the value of CLSID. #### MsoEnvelope A structure that contains information about the email message being sent. [TABLE] **Ver (4 bytes):** An unsigned integer that specifies the version of this envelope. **LastSentTime (4 bytes):** A signed integer that specifies the last time this email message was sent. Time is represented as the number of minutes since 12:00 AM January 1, 1601. The value MUST be greater than or equal to 0 and less than or equal to 0x5AE980E0. The default value is 0x5AE980E0, which means no time was specified. **FlagStatus (4 bytes):** An unsigned integer that specifies the follow-up status of this email message. Values are zero for not flagged for follow-up, 1 for flagged for follow-up, and 2 for completed follow-up. **ReplyTime (4 bytes):** A signed integer that specifies when the last reply was received for this email message. The time is represented as the number of minutes since 12:00 AM January 1, 1601. The value MUST be greater than or equal to zero and less than or equal to 0x5AE980E0. The default value is 0x5AE980E0, which means no time was specified. **RequestStrSize (2 bytes):** An unsigned integer that contains the size, in characters, of **RequestStr**. **RequestStr (variable):** A character array that contains the request string. For example, if the sender has set a flag on this email message with "No Response Necessary", this string contains "No Response Necessary". If **Ver** is 6, this is an [**ANSI character set**](#gt_100cd8a6-5cb1-4895-9de6-e4a3c224a583) array. If **Ver** is 8, this is a [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) character array. **SentRepresentingEntryIdSize (4 bytes):** An unsigned integer that contains the size, in bytes, of **SentRepresentingEntryId**. **SentRepresentingEntryId (variable):** An array of bytes that specifies the PR_SENT_REPRESENTING_ENTRYID as specified in [\[MS-OXPROPS\]](%5bMS-OXPROPS%5d.pdf#Section_f6ab1613aefe447da49c18217230b148). **SentRepresentingNameSize (2 bytes):** An unsigned integer that contains the size, in characters, of **SentRepresentingName**. **SentRepresentingName (variable):** A character array that specifies the PR_SENT_REPRESENTING_NAME as specified in \[MS-OXPROPS\]. If **Ver** is 6, this is an ANSI character set array. If **Ver** is 8, this is a Unicode character array. **InetAcctStampSize (2 bytes):** An unsigned integer that contains the size, in characters, of **InetAcctStamp**. **InetAcctStamp (variable):** A character array that specifies the **dispidInetAcctStamp** as specified in \[MS-OXPROPS\]. If **Ver** is 6, this is an ANSI character set array. If **Ver** is 8, this is a Unicode character array. **InetAcctNameSize (2 bytes):** An unsigned integer that contains the size, in characters, of **InetAcctName**. **InetAcctName (variable):** A character array that contains the **dispidInetAcctName** as specified in \[MS-OXPROPS\]. If **Ver** is 6, this is an ANSI character set array. If **Ver** is 8, this is a Unicode character array. **ExpiryTime (4 bytes):** A signed integer that specifies the time this email message expires. The time is represented as the number of minutes since 12:00 AM January 1, 1601. The value MUST be greater than or equal to 0 and less than or equal to 0x5AE980E0. The default value is 0x5AE980E0, which means no time was specified. **DeferredDeliveryTime (4 bytes):** A signed integer that specifies the time to send this email message. The time is represented as the number of minutes since 12:00 AM January 1, 1601. The value MUST be greater than or equal to 0 and less than or equal to 0x5AE980E0. The default value is 0x5AE980E0, which means no time was specified. **DeleteAfterSubmit (4 bytes):** An unsigned integer that specifies whether to delete the message after a recipient has submitted a reply. Values are zero for no, and 1 for yes. MUST be zero or 1. **SecurityFlags (4 bytes):** A bit field that specifies the security settings for this email message. The least significant bit specifies whether the email message is signed, and the next bit specifies whether the email message is encrypted. All other bits MUST be zero. **OriginatorDeliveryReportRequested (4 bytes):** An unsigned integer that specifies whether to send a delivery receipt to the sender. Values are zero for no and 1 for yes. MUST be zero or 1. **ReadReceiptRequested (4 bytes):** An unsigned integer that specifies whether to send a read receipt to the sender. Values are zero for no and 1 for yes. MUST be zero or 1. **CategoriesStrSize (2 bytes):** An unsigned integer that contains the size, in characters, of **CategoriesStr**. **CategoriesStr (variable):** A character array that contains the category for this email message. For example, "Business" or "Favorites". If **Ver** is 6, this is an ANSI character set array. If **Ver** is 8, this is a Unicode character array. **Sensitivity (4 bytes):** An unsigned integer that specifies the sensitivity of the email message. Values are zero for Normal, 1 for Personal, 2 for Private, and 3 for Confidential. MUST be less than 4. **Importance (4 bytes):** An unsigned integer that specifies the importance flag of the email message. Values are 0 for Low, 1 for Normal, and 2 for High. MUST be less than 3. **SubjectSize (2 bytes):** An unsigned integer that contains the size, in characters, of **Subject**. **Subject (variable):** A character array that contains the subject of the email message. If **Ver** is 6, this is an ANSI character set array. If **Ver** is 8, this is a Unicode character array. **VotingOptionsSize (2 bytes):** An unsigned integer that contains the size, in characters, of the **VotingOptions**. **VotingOptions (variable):** An ANSI character array that contains the voting option choices separated by a semicolon. For example, "Yes;No;Maybe". **ReplyRecipients (variable):** An [**EnvRecipientCollection**](#Section_5deabdf8d4604a4ca0a64cb7cefaf75d) (section 2.3.8.3) that contains the recipients of replies to this email message. **ContactLinkRecipients (variable):** An **EnvRecipientCollection** (section 2.3.8.3) that contains the sender contacts to whom the email message is to be sent. This is not present if **Ver** does not equal 8. **Recipients (variable):** An **EnvRecipientCollection** (section 2.3.8.3) that contains the recipients to receive this email message. **Attachments (variable):** An [**EnvAttachmentCollection**](#Section_706192e0b6734ba2a1548f4dfc9f0165) (section 2.3.8.17) that contains information about attachments for this email message. **IntroText (variable):** If **Ver** equals 8, this is an [**IntroText**](#Section_01e96fcbe7504b1f94249d05b8545403) (section 2.3.8.19). This is not present if **Ver** does not equal 8. #### EnvRecipientCollection *Referenced by: [MsoEnvelope](#Section_f7c1375ecff349c6b62f39492273827c)* A collection that contains information about recipients for an email message. [TABLE] **RecipientCollTag (4 bytes):** An unsigned integer that contains a version tag for the recipient collection. MUST be 0xDCCA0123. **RecipientCollVer (4 bytes):** An unsigned integer that contains a version for the recipient collection. MUST be 1. **Count (4 bytes):** An unsigned integer that contains the number of recipients in the **Recipients** array. **Recipients (variable):** An array of [**EnvRecipientProperties**](#Section_f9e2a31453104779b5a8ecf6817703bd) (section 2.3.8.4) that contains the properties for each recipient. #### EnvRecipientProperties *Referenced by: [EnvRecipientCollection](#Section_5deabdf8d4604a4ca0a64cb7cefaf75d)* An **EnvRecipientProperties** structure that contains the properties of a single email message recipient. [TABLE] **Count (4 bytes):** An unsigned integer that contains the number of properties for this recipient. **Ignored (4 bytes):** MUST be ignored. **Properties (variable):** An array of [**EnvRecipientProperty**](#Section_8df36d0a49eb4f41910bcec9ba5120e8) (section 2.3.8.5) that has the size of **Count**. #### EnvRecipientProperty *Referenced by: [EnvRecipientProperties](#Section_f9e2a31453104779b5a8ecf6817703bd)* A single property for an email message recipient. These properties are specified in [\[MS-OXCDATA\]](%5bMS-OXCDATA%5d.pdf#Section_1afa0cd9b1a04520b623bf15030af5d8). Only the sizes of the properties are described here. [TABLE] **PropTag (4 bytes):** An unsigned integer that contains the property identifier tag. **PropData (variable):** An [**EnvRecipientPropertyBlob**](#Section_2ce2498ef44f4ceaaf7059c3abc4c129) (section 2.3.8.6), the type of which is specified by **PropTag**. #### EnvRecipientPropertyBlob *Referenced by: [EnvRecipientProperty](#Section_8df36d0a49eb4f41910bcec9ba5120e8)* A structure that describes the size of the data for a single recipient property. The type of this structure is specified by the **PropTag** of a **EnvRecipientProperty** (section 2.3.8.5). | Value | Meaning | |----|----| | 0x0003 | The property data is a [**PT_LONG**](#Section_14c87459b96747838c07c577771d4692) (section 2.3.8.7). | | 0x0001 | The property data is a [**PT_NULL**](#Section_baff4515df094c9f85ecc5c1b2750111) (section 2.3.8.8). | | 0x000B | The property data is a [**PT_BOOLEAN**](#Section_bfed9f7b80e24683b8aae31c269edc37) (section 2.3.8.9). | | 0x0040 | The property data is a [**PT_SYSTIME**](#Section_b9f7856615ae419fafa944265c9f4092) (section 2.3.8.10). | | 0x000A | The property data is a [**PT_ERROR**](#Section_b26e9a2c53c047e89961999b63be162a) (section 2.3.8.11). | | 0x001E | The property data is a [**PT_STRING8**](#Section_0c75d01a68c844bf9b4480a73d052db5) section 2.3.8.12). | | 0x001F | The property data is a [**PT_UNICODE**](#Section_274cc379b1964a8f89baeb9cf0baf7fc) (section 2.3.8.13). | | 0x0102 | The property data is a [**PT_BINARY**](#Section_5eb7ad4f284c427ea7f6b2b418a0b403) (section 2.3.8.14). | | 0x101E | The property data is a [**PT_MV_STRING8**](#Section_19c08692116741bf9801053c11225c69) (section 2.3.8.15). | | 0x1102 | The property data is a [**PT_MV_BINARY**](#Section_21b12ab606c44eaabf302224ccac74f1) (section 2.3.8.16). | #### PT_LONG *Referenced by: [EnvRecipientPropertyBlob](#Section_2ce2498ef44f4ceaaf7059c3abc4c129)* A recipient property that is an unsigned integer as specified in [\[MS-OXCDATA\]](%5bMS-OXCDATA%5d.pdf#Section_1afa0cd9b1a04520b623bf15030af5d8). [TABLE] **Value (4 bytes):** The value for this property as specified in \[MS-OXCDATA\]. #### PT_NULL *Referenced by: [EnvRecipientPropertyBlob](#Section_2ce2498ef44f4ceaaf7059c3abc4c129)* A recipient property that is an unsigned integer as specified in [\[MS-OXCDATA\]](%5bMS-OXCDATA%5d.pdf#Section_1afa0cd9b1a04520b623bf15030af5d8). [TABLE] **Value (4 bytes):** The value for this property as specified in \[MS-OXCDATA\]. #### PT_BOOLEAN *Referenced by: [EnvRecipientPropertyBlob](#Section_2ce2498ef44f4ceaaf7059c3abc4c129)* A recipient property that is an unsigned integer as specified in [\[MS-OXCDATA\]](%5bMS-OXCDATA%5d.pdf#Section_1afa0cd9b1a04520b623bf15030af5d8). [TABLE] **Value (2 bytes):** The value of the property as specified in \[MS-OXCDATA\]. #### PT_SYSTIME *Referenced by: [EnvRecipientPropertyBlob](#Section_2ce2498ef44f4ceaaf7059c3abc4c129)* A recipient property that is a **FILETIME** value as specified in [\[MS-OXCDATA\]](%5bMS-OXCDATA%5d.pdf#Section_1afa0cd9b1a04520b623bf15030af5d8). [TABLE] **HighValue (4 bytes):** The first part of the property's value. **LowValue (4 bytes):** The second part of the property's value. #### PT_ERROR *Referenced by: [EnvRecipientPropertyBlob](#Section_2ce2498ef44f4ceaaf7059c3abc4c129)* A recipient property that is an unsigned integer as specified in [\[MS-OXCDATA\]](%5bMS-OXCDATA%5d.pdf#Section_1afa0cd9b1a04520b623bf15030af5d8). [TABLE] **Value (4 bytes):** The value of the property as specified in \[MS-OXCDATA\]. #### PT_STRING8 *Referenced by: [EnvRecipientPropertyBlob](#Section_2ce2498ef44f4ceaaf7059c3abc4c129), [PT_MV_STRING8](#Section_19c08692116741bf9801053c11225c69)* A recipient property that is an [**ANSI character set**](#gt_100cd8a6-5cb1-4895-9de6-e4a3c224a583) string as specified in [\[MS-OXCDATA\]](%5bMS-OXCDATA%5d.pdf#Section_1afa0cd9b1a04520b623bf15030af5d8). [TABLE] **Size (2 bytes):** An unsigned integer that specifies the size, in bytes, of **Value**. **Value (variable):** An array of characters from the ANSI character set as specified in \[MS-OXCDATA\]. #### PT_UNICODE *Referenced by: [EnvRecipientPropertyBlob](#Section_2ce2498ef44f4ceaaf7059c3abc4c129)* A recipient property that is a [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string as specified in [\[MS-OXCDATA\]](%5bMS-OXCDATA%5d.pdf#Section_1afa0cd9b1a04520b623bf15030af5d8). [TABLE] **Size (2 bytes):** An unsigned integer that specifies the size, in bytes, of **Value**. **Value (variable):** A Unicode string as specified in \[MS-OXCDATA\]. #### PT_BINARY *Referenced by: [EnvRecipientPropertyBlob](#Section_2ce2498ef44f4ceaaf7059c3abc4c129), [PT_MV_BINARY](#Section_21b12ab606c44eaabf302224ccac74f1)* A recipient property that is an array of bytes as specified in [\[MS-OXCDATA\]](%5bMS-OXCDATA%5d.pdf#Section_1afa0cd9b1a04520b623bf15030af5d8). [TABLE] **Size (2 bytes):** An unsigned integer that contains the size, in bytes, of **Data**. **Data (variable):** An array of bytes as specified in \[MS-OXCDATA\]. #### PT_MV_STRING8 *Referenced by: [EnvRecipientPropertyBlob](#Section_2ce2498ef44f4ceaaf7059c3abc4c129)* A recipient property that consists of multiple [**ANSI character set**](#gt_100cd8a6-5cb1-4895-9de6-e4a3c224a583) strings as specified in [\[MS-OXCDATA\]](%5bMS-OXCDATA%5d.pdf#Section_1afa0cd9b1a04520b623bf15030af5d8). [TABLE] **Count (4 bytes):** An unsigned integer that specifies the number of elements in **Data**. **Data (variable):** An array of [**PT_STRING8**](#Section_0c75d01a68c844bf9b4480a73d052db5) (section 2.3.8.12) as specified in \[MS-OXCDATA\]. #### PT_MV_BINARY *Referenced by: [EnvRecipientPropertyBlob](#Section_2ce2498ef44f4ceaaf7059c3abc4c129)* A recipient property that consists of multiple byte arrays as specified in [\[MS-OXCDATA\]](%5bMS-OXCDATA%5d.pdf#Section_1afa0cd9b1a04520b623bf15030af5d8). [TABLE] **Count (4 bytes):** An unsigned integer that specifies the number of elements in **Data**. **Data (variable):** An array of [**PT_BINARY**](#Section_5eb7ad4f284c427ea7f6b2b418a0b403) (section 2.3.8.14) as specified in \[MS-OXCDATA\]. #### EnvAttachmentCollection *Referenced by: [MsoEnvelope](#Section_f7c1375ecff349c6b62f39492273827c)* A collection that contains the data for each of the attachments for an email message. [TABLE] **Count (4 bytes):** An unsigned integer that contains the number of attachments for an email message. **Attachments (variable):** An array of [**EnvAttachment**](#Section_a8ff6fd332d14fd0ad6a5f3a0cf3bcce) (section 2.3.8.18) of size **Count** that contains the data for each attachment. #### EnvAttachment *Referenced by: [EnvAttachmentCollection](#Section_706192e0b6734ba2a1548f4dfc9f0165)* A structure that contains the data for a single email message attachment. [TABLE] **AttachmentMethod (4 bytes):** An unsigned integer that represents the MAPI property **PR_ATTACH_METHOD**, as specified in [\[MS-OXPROPS\]](%5bMS-OXPROPS%5d.pdf#Section_f6ab1613aefe447da49c18217230b148). **AttachmentNameSize (1 byte):** A byte that contains the size, in characters, of **AttachmentName**. **AttachmentName (variable):** A [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) character array that contains the file name of the attachment. **AttachmentSizeLowOrderBits (4 bytes):** An unsigned integer that contains the low-order bits for the file size of the attachment. **AttachmentSizeHighOrderBits (4 bytes):** An unsigned integer that contains the high-order bits for the file size of the attachment. **Data (variable):** An array of bytes that contains the content of the attachment. #### IntroText Specifies the text of the introduction for the document when sent as an email message. [TABLE] **IntroTextSize (4 bytes):** An unsigned integer that specifies the size, in bytes, of **IntroText**. MUST be evenly divisible by two. **IntroText (variable):** A [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) character array that specifies the introduction text. ### Document Signature Serialized Certificate Store Structure This section specifies a serialized [**digital certificate store**](#gt_d6f48603-2840-4629-a813-8ed96f69928b) that is persisted as part of a collection of document signatures, as specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) section 2.5. #### DocSigSerializedCertStore The serialized [**digital certificate store**](#gt_d6f48603-2840-4629-a813-8ed96f69928b) specifies structures for storing a digital certificate store containing zero or more [**digital certificates**](#gt_a1dfa70d-7803-413d-8697-c40021a3f3d0) and, optionally, a list of properties associated with each certificate. [TABLE] **version (4 bytes):** An unsigned integer identifying the version of the structure. MUST be 0x00000000. **fileType (4 bytes):** An unsigned integer that specifies the type of data contained in the structure. MUST be the value 0x54524543. **certificateList (variable):** An array of [**CertStoreCertificateGroup**](#Section_462654f19be347f59c1ea6d328ac52e0) (section 2.3.2.5.4). This array can contain zero or more elements. Each element of the array specifies a digital certificate and a collection of optional properties associated with the certificate. Elements of this array are read and processed until a **CertStoreCertificateGroup.SerializedPropertyEntry.id** is read with the unsigned integer value 0x00000000, which specifies the end of this array and the beginning of the **endMarkerElement** field. The terminating **CertStoreCertificateGroup.SerializedPropertyEntry.id** value read is actually the **endMarkerElement.id** field and not part of this field. **endMarkerElement (12 bytes):** An [**EndElementMarkerEntry**](#Section_020eb66c88e3466b80f60e3ce84d0544) structure (section 2.3.2.5.2) specifying the end of the structure. ## Common Algorithms ### Unicode String to Unsigned Integer Hash Given a null-terminated [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string, a 4-byte unsigned integer [**hash**](#gt_b7e2b611-0af5-4fec-8af2-3f9ce7bad205) value can be obtained by performing the following algorithm: 1. 2. 3. 4. Set a 4-byte unsigned integer value **dwHash** equal to 0x00000000.Truncate the **input string** to 255 characters plus the null-terminating character.Convert the **input string** to lower case.For each set of 2 characters (**Char1**, **Char2**) from position 0 to the end of the **input string** (for example, \[0,1\], \[2,3\], \[4,5\], …, \[255, \\]) perform the following steps.Example: 223. for (i=0; i\.%....... 00000540: 00 00 03 00 00 00 00 00 00 00 03 00 00 00 05 00 ................ 00000550: 00 00 1F 00 00 00 31 00 00 00 68 00 74 00 74 00 ......1...h.t.t. 00000560: 70 00 3A 00 2F 00 2F 00 65 00 6E 00 2E 00 61 00 p.:././.e.n...a. 00000570: 64 00 61 00 74 00 75 00 6D 00 2E 00 63 00 6F 00 d.a.t.u.m...c.o. 00000580: 6D 00 2F 00 61 00 63 00 63 00 6F 00 75 00 6E 00 m./.a.c.c.o.u.n. 00000590: 74 00 69 00 6E 00 67 00 2F 00 6D 00 61 00 6E 00 t.i.n.g./.m.a.n. 000005A0: 61 00 67 00 65 00 72 00 6C 00 69 00 73 00 74 00 a.g.e.r.l.i.s.t. 000005B0: 2E 00 68 00 74 00 6D 00 6C 00 00 00 00 00 1F 00 ..h.t.m.l....... 000005C0: 00 00 0F 00 00 00 65 00 6D 00 61 00 69 00 6C 00 ......e.m.a.i.l. 000005D0: 41 00 64 00 64 00 72 00 65 00 73 00 73 00 65 00 A.d.d.r.e.s.s.e. 000005E0: 73 00 00 00 00 00 03 00 00 00 28 00 6B 00 03 00 s.........(.k... 000005F0: 00 00 FF FF FF FF 03 00 00 00 03 04 00 00 03 00 ................ 00000600: 00 00 04 00 00 00 1F 00 00 00 01 00 00 00 00 00 ................ 00000610: 79 32 1F 00 00 00 19 00 00 00 5F 00 53 00 6B 00 y2........\_.S.k. 00000620: 69 00 70 00 2D 00 6C 00 65 00 76 00 65 00 6C 00 i.p.-.l.e.v.e.l. 00000630: 5F 00 56 00 65 00 72 00 69 00 66 00 69 00 63 00 \_.V.e.r.i.f.i.c. 00000640: 61 00 74 00 69 00 6F 00 6E 00 00 00 00 00 1E 00 a.t.i.o.n....... 00000650: 00 00 0C 00 00 00 41 63 63 6F 75 6E 74 69 6E 67 ......Accounting 00000660: 00 00 03 00 00 00 05 00 00 00 0B 00 00 00 00 00 ................ 00000670: 00 00 1E 00 00 00 18 00 00 00 53 69 67 6E 20 74 ..........Sign t 00000680: 68 65 20 61 70 70 72 6F 76 61 6C 20 66 6F 72 6D he approval form 00000690: 00 00 1E 00 00 00 1C 00 00 00 53 6B 69 70 4C 65 ..........SkipLe 000006A0: 76 65 6C 56 65 72 69 66 69 63 61 74 69 6F 6E 53 velVerificationS 000006B0: 74 61 72 74 00 00 00 00 tart.... ### Document Summary Information Stream Overview The following table contains the beginning part of a Document Summary Information [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6). There are two [**FilePointers**](#Section_0566aac8327c404186e5e4142458d93e) (section 2.2.1.5) in this section that point to a [**Document Summary Information property set**](#Section_fe59ffd979e944fba1c92466057b05c6) (section 2.3.3.2.2) and a [**User Defined property set**](#Section_54514afbff194348be71395854d4432d) (section 2.3.3.2.3), respectively. | **Offset** | **Size** | **Structure** | **Value** | |----|----|----|----| | 00000000 | 06B8 | PropertySetStream **- DocumentSummaryInfoStream** | | | 00000000 | 0044 | Stream header **- PropertySetStream** | | | 00000000 | 0002 | WORD **- byteOrder** | 0xFFFE | | 00000002 | 0002 | WORD **- version** | 0x0000 | | 00000004 | 0004 | [PropertySetSystemIdentifier](#Section_6ac486b48d634cdebd729c2306a482fe) **- sysId** | | | 00000004 | 0001 | BYTE **- OSMajorVersion** | 0x05 | | 00000005 | 0001 | BYTE **- OSMinorVersion** | 0x01 | | 00000006 | 0002 | WORD **- OSType** | 0x0002 | | 00000008 | 0010 | GUID **- applicationClsid** | 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 | | 00000018 | 0004 | DWORD **- cSections** | 0x00000002 | | 0000001C | 0028 | Array of identifier and offset **- rgIdOffset** | | | 0000001C | 0014 | Identifier and offset **- IdOffsetElement-1** | | | 0000001C | 0010 | GUID **- formatId** | 02 D5 CD D5 9C 2E 1B 10 93 97 08 00 2B 2C F9 AE | | 0000002C | 0004 | FilePointer **- sectionOffset** | 0x00000044 | | 00000030 | 0014 | Identifier and offset **- IdOffsetElement-2** | | | 00000030 | 0010 | GUID **- formatId** | 05 D5 CD D5 9C 2E 1B 10 93 97 08 00 2B 2C F9 AE | | 00000040 | 0004 | FilePointer **- sectionOffset** | 0x00000298 | | 00000044 | 0254 | **A**: PropertySet **- DocumentSummaryInformation** | | | 00000298 | 0420 | **B**: PropertySet **- UserDefinedProperties** | | Figure 15: Overview of a DocumentSummaryInfoStream **DocumentSummaryInfoStream:** This is an example of the **PropertySetStream** as described in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.21](http://msdn.microsoft.com/en-us/library/6e65d6fa-6044-4e23-ae71-d65d1e3b1249/). **PropertySetStream.byteOrder:** 0xFFFE is a reserved value. **PropertySetStream.version:** 0x0000 is the version number of the property set. **PropertySetStream.sysId.OSMajorVersion:** 0x05 indicates that the [**major version**](#gt_66583c77-eb07-43c4-8f1b-dd157580db46) of the operating system that created the file is 5. **PropertySetStream.sysId.OSMinorVersion:** 0x01 indicates that the [**minor version**](#gt_e0d99b53-9426-4a45-8429-b012184a4045) of the operating system that created the file is 1. **PropertySetStream.sysId.OSType:** 0x0002 is a reserved value. **PropertySetStream.applicationClsid:** 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 is the CLID_NULL. It is a reserved value. **PropertySetStream.cSections:** 0x00000002 indicates that this instance of a Document Summary Information stream contains two property sets, the **Document Summary Information property set** (section 2.3.3.2.2) and the **User Defined property set** (section 2.3.3.2.3). **PropertySetStream.rgIdOffset.IdOffsetElement-1:** The first element in the **rgIdOffset** array. **PropertySetStream.rgIdOffset.IdOffsetElement-1.formatId:** 02 D5 CD D5 9C 2E 1B 10 93 97 08 00 2B 2C F9 AE is the FMTID_DocSummaryInformation. It indicates that the associated **sectionOffset** points to a **Document Summary Information property set** (section 2.3.3.2.2). **PropertySetStream.rgIdOffset.IdOffsetElement-1.sectionOffset:** 0x00000044 indicates that the beginning of the **Document Summary Information property set** (section 2.3.3.2.2) is 0x00000044 bytes after the beginning of the Document Summary Information stream. In this example, **DocumentSummaryInfoStream** begins at offset 0x00000000. Therefore, the **Document Summary Information property set** (section 2.3.3.2.2) begins at offset 0x00000044. See [Document Summary Information Property Set Overview](#Section_c0e0190a08284638ab746fc190da3582) (section 3.2.2) for an example of this. **PropertySetStream.rgIdOffset.IdOffsetElement-2:** The second element in the **rgIdOffset** array. **PropertySetStream.rgIdOffset.IdOffsetElement-2.formatId:** 05 D5 CD D5 9C 2E 1B 10 93 97 08 00 2B 2C F9 AE is the FMTID_UserDefinedProperties. It indicates that the associated **sectionOffset** points to a **User Defined property set** (section 2.3.3.2.3). **PropertySetStream.rgIdOffset.IdOffsetElement-2.sectionOffset:** 0x00000298 indicates that the beginning of the **User Defined property set** (section 2.3.3.2.3) is 0x00000298 bytes after the beginning of the Document Summary Information stream. In this example, **DocumentSummaryInfoStream** begins at offset 0x00000000. Therefore, the **User Defined property set** (section 2.3.3.2.3) begins at offset 0x00000298. See [User Defined Property Set Overview](#Section_283eeaa13610403da42032c8a16945e0) (section 3.2.3) for an example of this. ### Document Summary Information Property Set Overview The following table contains the beginning of a [**Document Summary Information property set**](#Section_fe59ffd979e944fba1c92466057b05c6) (section 2.3.3.2.2) [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6). | **Offset** | **Size** | **Structure** | **Value** | |----|----|----|----| | 00000044 | 0254 | **A**: PropertySet **- DocumentSummaryInformation** | | | 00000044 | 0004 | DWORD **- cbSection** | 0x00000254 | | 00000048 | 0004 | DWORD **- cProps** | 0x0000000F | | 0000004C | 0078 | Array of PropertyIdentifierAndOffset **- rgProps** | | | 0000004C | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-1** | | | 0000004C | 0004 | DWORD **- propId** | 0x00000001 | | 00000050 | 0004 | FilePointer **- propOffset** | 0x00000080 | | 00000054 | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-2** | | | 00000054 | 0004 | DWORD **- propId** | 0x00000002 | | 00000058 | 0004 | FilePointer **- propOffset** | 0x00000088 | | 0000005C | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-3** | | | 0000005C | 0004 | DWORD **- propId** | 0x0000000E | | 00000060 | 0004 | FilePointer **- propOffset** | 0x0000009C | | 00000064 | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-4** | | | 00000064 | 0004 | DWORD **- propId** | 0x0000000F | | 00000068 | 0004 | FilePointer **- propOffset** | 0x000000B0 | | 0000006C | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-5** | | | 0000006C | 0004 | DWORD **- propId** | 0x0000001B | | 00000070 | 0004 | FilePointer **- propOffset** | 0x000000C0 | | 00000074 | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-6** | | | 00000074 | 0004 | DWORD **- propId** | 0x00000005 | | 00000078 | 0004 | FilePointer **- propOffset** | 0x000000D0 | | 0000007C | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-7** | | | 0000007C | 0004 | DWORD **- propId** | 0x00000006 | | 00000080 | 0004 | FilePointer **- propOffset** | 0x000000D8 | | 00000084 | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-8** | | | 00000084 | 0004 | DWORD **- propId** | 0x00000011 | | 00000088 | 0004 | FilePointer **- propOffset** | 0x000000E0 | | 0000008C | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-9** | | | 0000008C | 0004 | DWORD **- propId** | 0x00000017 | | 00000090 | 0004 | FilePointer **- propOffset** | 0x000000E8 | | 00000094 | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-10** | | | 00000094 | 0004 | DWORD **- propId** | 0x0000000B | | 00000098 | 0004 | FilePointer **- propOffset** | 0x000000F0 | | 0000009C | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-11** | | | 0000009C | 0004 | DWORD **- propId** | 0x00000010 | | 000000A0 | 0004 | FilePointer **- propOffset** | 0x000000F8 | | 000000A4 | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-12** | | | 000000A4 | 0004 | DWORD **- propId** | 0x00000013 | | 000000A8 | 0004 | FilePointer **- propOffset** | 0x00000100 | | 000000AC | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-13** | | | 000000AC | 0004 | DWORD **- propId** | 0x00000016 | | 000000B0 | 0004 | FilePointer **- propOffset** | 0x00000108 | | 000000B4 | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-14** | | | 000000B4 | 0004 | DWORD **- propId** | 0x0000000D | | 000000B8 | 0004 | FilePointer **- propOffset** | 0x00000110 | | 000000BC | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-15** | | | 000000BC | 0004 | DWORD **- propId** | 0x0000000C | | 000000C0 | 0004 | FilePointer **- propOffset** | 0x0000021D | | 000000C4 | 01D4 | Array of TypedPropertyValue structures **- DocSumProperties** | | Figure 16: Overview of a DocumentSummaryInformation property set In this table, there is an array of 15 elements, **rgProps**. Each element in **rgProps** is a **PropertyIdentifierAndOffset** structure ([\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.19](http://msdn.microsoft.com/en-us/library/f59e6c94-a0ae-4d1b-85d3-f01c35779a22/)). Each of these structures represents a property that is stored in this **Document Summary Information property set** (section 2.3.3.2.2). Each **PropertyIdentifierAndOffset** structure (**PidOffsetElement-1** through **PidOffsetElement-15**) contains two fields, **propId** and **propOffset**. The **propId** field indicates the property of that element according to **PIDDSI** (section [2.3.3.2.2.1](#Section_3ef02e83afef4b6c9585c109edd24e07)). The **propOffset** field indicates the offset to the **TypedPropertyValue** (\[MS-OLEPS\] section [2.15](http://msdn.microsoft.com/en-us/library/f122b9d7-e5cf-4484-8466-83f6fd94b3cc/)) structure containing the value of the property. In this example, some **PidOffsetElements** share the same structure and therefore are omitted for brevity. **PidOffsetElement-2** to **PidOffsetElement-5** are [**Lpstr**](#Section_fac324c9ff39442ebd181a91a723a818) properties (section 2.3.3.1.4). For the structure of an **Lpstr** property (section 2.3.3.1.4), see the [Category Property Example](#Section_29d75dd8a0654c23948c8f705f01f986) (section 3.2.2.2). **PidOffsetElement-6** to **PidOffsetElement-9** are VT_I4 **TypedPropertyValue** properties. For the structure of a VT_I4 **TypedPropertyValue** property, see the [**LineCount Property Example**](#Section_c93a7a10a41945639a2ed4b4dc51cf94) section 3.2.2.3). **PidOffsetElement-10** to **PidOffsetElement-13** are VT_BOOL **TypedPropertyValue** properties. For the structure of a VT_BOOL **TypedPropertyValue** property, see the [**LinksDirty Property Example**](#Section_073efdcc7d75400396a9c48f4a3ce77c) (section 3.2.2.4). **DocumentSummaryInformation:** A **DocumentSummaryInformation** is a property set as described in \[MS-OLEPS\] section [2.20](http://msdn.microsoft.com/en-us/library/aefcbddf-f299-4f5e-a9da-65ce4ca55075/). **cbSection:** 0x00000254 indicates the count of bytes from the beginning of the DocumentSummaryInformation property set (at offset 0x00000044) to the end of the last property in the property set, [**HeadingPairs**](#Section_887bb6a81f9c4d4abf3dcf6062e4c6a4) (section 3.2.2.6), at offset 0x00000297 inclusive. **cProps:** 0x0000000F indicates that this **Document Summary Information property set** (section 2.3.3.2.2) contains 0x0000000F (15) properties. **rgProps:** This is the container of an array of **PropertyIdentifierAndOffset** structures. In this example, there are 15 elements, one for each property. **rgProps.PidOffsetElement-1:** CodePage (VT_I2 **TypedPropertyValue** property). **rgProps.PidOffsetElement-1.propId:** 0x00000001 (**GKPIDDSI_CODEPAGE** (section 2.3.3.2.2.1) indicates that there is a **CodePage** property value at the stream offset indicated by **propOffset**. **rgProps.PidOffsetElement-1.propOffset:** 0x00000080 indicates that the beginning of the **CodePage** property data is 0x00000080 bytes after the beginning of the **Document Summary Information property set** (section 2.3.3.2.2). In this example, **DocumentSummaryInformation** begins at offset 0x00000044. Therefore, the **CodePage** property begins at offset 0x000000C4. See the [**CodePage Property Example**](#Section_ee2488688fde440db81bbc27d1c7811d) (section 3.2.2.1). **rgProps.PidOffsetElement-2:** Category (**Lpstr** property (section 2.3.3.1.4)). **rgProps.PidOffsetElement-2.propId:** 0x00000002 (**GKPIDDSI_CATEGORY** (section 2.3.3.2.2.1)) indicates that there is a **Category** property value at the stream offset indicated by **propOffset**. **rgProps.PidOffsetElement-2.propOffset:** 0x00000088 indicates that the beginning of the **Category** property data is 0x00000088 bytes after the beginning of the **Document Summary Information property set** (section 2.3.3.2.2). In this example, **DocumentSummaryInformation** begins at offset 0x00000044. Therefore, the **Category** property begins at offset 0x000000CC. See the Category Property Example (section 3.2.2.2). **rgProps.PidOffsetElement-3:** Manager (**Lpstr** property (section 2.3.3.1.4)). **rgProps.PidOffsetElement-4:** Company (**Lpstr** property (section 2.3.3.1.4)). **rgProps.PidOffsetElement-5:** ContentStatus (**Lpstr** property (section 2.3.3.1.4)). **rgProps.PidOffsetElement-6:** LineCount (VT_I4 **TypedPropertyValue** property). **rgProps.PidOffsetElement-6.propId:** 0x00000005 (**GKPIDDSI_LINECOUNT** (section 2.3.3.2.2.1) indicates that there is a **LineCount** property value at the stream offset indicated by **propOffset**. **rgProps.PidOffsetElement-6.propOffset:** 0x000000D0 indicates that the **LineCount** property data is 0x000000D0 bytes after the beginning of the **Document Summary Information property set** (section 2.3.3.2.2). In this example, **DocumentSummaryInformation** begins at offset 0x00000044. Therefore, the **LineCount** property begins at offset 0x00000114. See the **LineCount Property Example** (section 3.2.2.3). **rgProps.PidOffsetElement-7:** ParagraphCount (VT_I4 **TypedPropertyValue** property). **rgProps.PidOffsetElement-8:** CountCharsWithSpaces (VT_I4 **TypedPropertyValue** property). **rgProps.PidOffsetElement-9:** Version (VT_I4 **TypedPropertyValue** property). **rgProps.PidOffsetElement-10:** Scale (VT_BOOL **TypedPropertyValue** property). **rgProps.PidOffsetElement-11:** LinksDirty (VT_BOOL **TypedPropertyValue** property). **rgProps.PidOffsetElement-11.propId:** 0x00000010 (**GKPIDDSI_LINKSDIRTY** (section 2.3.3.2.2.1)) indicates that there is a **LinksDirty** property value at the stream offset indicated by **propOffset**. **rgProps.PidOffsetElement-11.propOffset:** 0x000000F8 indicates that the **LinksDirty** property data is 0x000000F8 bytes after the beginning of the **Document Summary Information property set** (section 2.3.3.2.2). In this example, **DocumentSummaryInformation** begins at offset 0x00000044. Therefore, the **LinksDirty** property begins at offset 0x00000013C. See the **LinksDirty Property Example** (section 3.2.2.4). **rgProps.PidOffsetElement-12:** SharedDoc (VT_BOOL **TypedPropertyValue** property). **rgProps.PidOffsetElement-13:** HyperlinksChanged (VT_BOOL **TypedPropertyValue** property). **rgProps.PidOffsetElement-14:** DocumentParts ([**VtVecUnalignedLpstr**](#Section_523af67dd69a4eb1848ba299674ac9b8) property (section 2.3.3.1.10)). **rgProps.PidOffsetElement-14.propId:** 0x0000000D (**GKPIDDSI_DOCPARTS** (section 2.3.3.2.2.1)) indicates that there is a **DocumentParts** property value at the stream offset indicated by **propOffset**. **rgProps.PidOffsetElement-14.propOffset:** 0x00000110 indicates that the **DocumentParts** property data is 0x00000110 bytes after the beginning of **Document Summary Information property set** (section 2.3.3.2.2). In this example, **DocumentSummaryInformation** begins at offset 0x00000044. Therefore, the **DocumentParts** property begins at offset 0x00000154. See the [**DocumentParts Property Example**](#Section_742bc556d7884900b7aeb8fe1f2e4322) (section 3.2.2.5). **rgProps.PidOffsetElement-15:** HeadingPairs ([**VtVecHeadingPair**](#Section_3aaaf9e84f1a42fa9359fe0ab0c1cccc) property (section 2.3.3.1.10)). **rgProps.PidOffsetElement-15.propId:** 0x0000000C (**GKPIDDSI_HEADINGPAIR** (section 2.3.3.2.2.1)) indicates that there is a **HeadingPairs** property value at the stream offset indicated by **propOffset**. **rgProps.PidOffsetElement-15.propOffset:** 0x0000021D indicates that the **HeadingPairs** property data is 0x0000021D bytes after the beginning of the **Document Summary Information property set** (section 2.3.3.2.2). In this example, **DocumentSummaryInformation** begins at offset 0x00000044. Therefore, the **HeadingPairs** property begins at offset 0x00000261. See the **HeadingPairs Property Example** (section 3.2.2.6). #### CodePage Property Example This is an example of a **CodePage** property (VT_I2 **TypedPropertyValue** property). | **Offset** | **Size** | **Structure** | **Value** | |------------|----------|--------------------------------------------|-----------| | 000000C4 | 0008 | TypedPropertyValue **- GKPIDDSI_CODEPAGE** | | | 000000C4 | 0002 | WORD **- wType** | 0x0002 | | 000000C6 | 0002 | WORD **- padding** | 0x0000 | | 000000C8 | 0002 | WORD **- value** | 0x04E4 | | 000000CA | 0002 | WORD **- unused** | 0x0000 | Figure 17: Structure of a CodePage property **GKPIDDSI_CODEPAGE:** CodePage. **wType:** 0x0002 indicates this property is a VT_I2 **TypedPropertyValue** property (2-byte integer). **value:** 0x04E4 (1252) indicates the [**code page**](#gt_210637d9-9634-4652-a935-ded3cd434f38) used for the property values of the [**Lpstr**](#Section_fac324c9ff39442ebd181a91a723a818) (section 2.3.3.1.4) and [**UnalignedLpstr**](#Section_a8f75582c3d34a5bbbca62ed6a05711d) (section 2.3.3.1.5) properties in the [Document Summary Information property set](#Section_fe59ffd979e944fba1c92466057b05c6) (section 2.3.3.2.2). #### Category Property Example This is an example of a **Category** property ([**Lpstr**](#Section_fac324c9ff39442ebd181a91a723a818) property (section 2.3.3.1.4)). | **Offset** | **Size** | **Structure** | **Value** | |------------|----------|--------------------------------------------|------------| | 000000CC | 0014 | TypedPropertyValue **- GKPIDDSI_CATEGORY** | | | 000000CC | 0002 | WORD **- wType** | 0x001E | | 000000CE | 0002 | WORD **- padding** | 0x0000 | | 000000D0 | 0010 | Lpstr **- stringValue** | | | 000000D0 | 0004 | DWORD **- cch** | 0x0000000C | | 000000D4 | 000C | Array of CHAR **- value** | Tutorials | Figure 18: Structure of a Category property **GKPIDDSI_CATEGORY:** Category. **wType:** 0x001E indicates that this property is an **Lpstr** property (section 2.3.3.1.4). **stringValue.cch:** 0x0000000C indicates that the count of characters of the **Lpstr** (section 2.3.3.1.4) value is 12. The **value** field contains 10 characters (9 for "Tutorials" plus a terminating NULL character). There are 2 additional bytes after the terminating NULL character which pad the **value** field to a multiple of 4 bytes. **stringValue.value:** The value of this field is "Tutorials" followed by a null-terminator and 2 bytes of padding, so the length of this field is 0x0000000C (12). The 2 bytes of padding is added to make the length a multiple of 4 bytes. #### LineCount Property Example This is an example of a **LineCount** property (VT_I4 **TypedPropertyValue** property). | **Offset** | **Size** | **Structure** | **Value** | |------------|----------|---------------------------------------------|------------| | 00000114 | 0008 | TypedPropertyValue **- GKPIDDSI_LINECOUNT** | | | 00000114 | 0002 | WORD **- wType** | 0x0003 | | 00000116 | 0002 | WORD **- padding** | 0x0000 | | 00000118 | 0004 | DWORD **- value** | 0x0000001F | Figure 19: Structure of a LineCount property **GKPIDDSI_LINECOUNT:** LineCount. **wType:** 0x0003 indicates that this property is a VT_I4 **TypedPropertyValue** property (4-byte integer). **value:** 0x0000001F indicates that the count of lines in the example document is 0x0000001F (31). #### LinksDirty Property Example This is an example of a **LinksDirty** property (VT_BOOL **TypedPropertyValue** property). | **Offset** | **Size** | **Structure** | **Value** | |------------|----------|----------------------------------------------|------------| | 0000013C | 0008 | TypedPropertyValue **- GKPIDDSI_LINKSDIRTY** | | | 0000013C | 0002 | WORD **- wType** | 0x000B | | 0000013E | 0002 | WORD **- padding** | 0x0000 | | 00000140 | 0004 | DWORD **- value** | 0x00000000 | Figure 20: Structure of a LinksDirty property **GKPIDDSI_LINKSDIRTY:** LinksDirty. **wType:** 0x000B indicates that this property is a VT_BOOL **TypedPropertyValue** property (false if the **value** field is 0x00000000, or true if it is any other value). **value:** 0x00000000 is the value of the **value** field of this VT_BOOL **TypedPropertyValue** property, meaning false. This indicates that the linked properties (**propId** 0x00000006 in the [**UserDefined property set**](#Section_283eeaa13610403da42032c8a16945e0) (section 3.2.3) in this example) do not require updating the next time the file is opened. #### DocumentParts Property Example This is an example of a **DocumentParts** property ([**VtVecUnalignedLpstr**](#Section_523af67dd69a4eb1848ba299674ac9b8) property (section 2.3.3.1.10)). The **DocumentParts** property ought to be viewed together with the [**HeadingPairs Property**](#Section_887bb6a81f9c4d4abf3dcf6062e4c6a4) (section 3.2.2.6) because the data in the two are closely related. This relationship is illustrated by the following diagram. ![Relationship between the DocumentParts property and the HeadingPairs property](media/image9.bin "Relationship between the DocumentParts property and the HeadingPairs property") Figure 21: Relationship between the DocumentParts property and the HeadingPairs property In the figure, the first element of the **HeadingPairs** property has a **headingString** value of "Title", meaning it is associated with the title group in the **DocumentParts** property. The value of the **headerParts** field is 1, meaning there is only 1 element in the **DocumentParts** property that is in the title group, **LpstrElement-1**. The **headingString** of the second element in the **HeadingPairs** property is "Headings", meaning this element is associated with the headings group in the **DocumentParts** property. **HeaderParts** equals 8, meaning there are 8 elements in the **DocumentParts** property that are in the headings group. They are **LpstrElement-2** through **LpstrElement-9**. | **Offset** | **Size** | **Structure** | **Value** | |----|----|----|----| | 00000154 | 010D | TypedPropertyValue **- GKPIDDSI_DOCPARTS** | | | 00000154 | 0002 | WORD **- wType** | 0x101E | | 00000156 | 0002 | WORD **- padding** | 0x0000 | | 00000158 | 0109 | [VtVecUnalignedLpstrValue](#Section_cd95ca9770c748288b5bb86263348026) **- UnalignedLpstr Vector** | | | 00000158 | 0004 | DWORD **- cElements** | 0x00000009 | | 0000015C | 0105 | Array of UnalignedLpstr **- rgString** | | | 0000015C | 0020 | [UnalignedLpstr](#Section_a8f75582c3d34a5bbbca62ed6a05711d) **- LpstrElement-1** | | | 0000015C | 0004 | DWORD **- cch** | 0x0000001C | | 00000160 | 001C | Array of CHAR **- value** | Invoice Approval Procedures | | 0000017C | 0017 | UnalignedLpstr **- LpstrElement-2** | | | 0000017C | 0004 | DWORD **- cch** | 0x00000013 | | 00000180 | 0013 | Array of CHAR **- value** | Approval Procedure | | 00000193 | 0019 | UnalignedLpstr **- LpstrElement-3** | | | 00000193 | 0004 | DWORD **- cch** | 0x00000015 | | 00000197 | 0015 | Array of CHAR **- value** | Manager Approval | | 000001AC | 001C | UnalignedLpstr **- LpstrElement-4** | | | 000001AC | 0004 | DWORD **- cch** | 0x00000018 | | 000001B0 | 0018 | Array of CHAR **- value** | Skip-level Approval | | 000001C8 | 0021 | UnalignedLpstr **- LpstrElement-5** | | | 000001C8 | 0004 | DWORD **- cch** | 0x0000001D | | 000001CC | 001D | Array of CHAR **- value** | Organizational Chart | | 000001E9 | 0024 | UnalignedLpstr **- LpstrElement-6** | | | 000001E9 | 0004 | DWORD **- cch** | 0x00000020 | | 000001ED | 0020 | Array of CHAR **- value** | Skip-level verification | | 0000020D | 0017 | UnalignedLpstr **- LpstrElement-7** | | | 0000020D | 0004 | DWORD **- cch** | 0x00000013 | | 00000211 | 0013 | Array of CHAR **- value** | Verification Steps | | 00000224 | 001D | UnalignedLpstr **- LpstrElement-8** | | | 00000224 | 0004 | DWORD **- cch** | 0x00000019 | | 00000228 | 0019 | Array of CHAR **- value** | Manager Verification | | 00000241 | 0020 | UnalignedLpstr **- LpstrElement-9** | | | 00000241 | 0004 | DWORD **- cch** | 0x0000001C | | 00000245 | 001C | Array of CHAR **- value** | Skip-level Verification | Figure 22: Structure of a DocumentParts property In this example, the **LpstrElements** share the same structure. For brevity, only one of them is explained in the following section. **LpstrElement-2** is explained because it is more representative in the calculation of count of bytes. **GKPIDDSI_DOCPARTS:** DocumentParts. **wType:** 0x101E indicates this property value is an array of single-byte character strings. In the case of **DocumentParts** this indicates the property is a **VtVecUnalignedLpstr** property (section 2.3.3.1.10). **UnalignedLpstr Vector.cElements:** 0x00000009 indicates there are 9 elements in the **VtVecUnalignedLpstr** (section 2.3.3.1.10). **UnalignedLpstr Vector.rgString.LpstrElement-2:** The second **UnalignedLpstr** (section 2.3.3.1.5) in this vector. **UnalignedLpstr Vector.rgString.LpstrElement-2.cch:** 0x00000013 (19) is the count of bytes of the **value** field of the **UnalignedLpstr** (section 2.3.3.1.5) ("Approval Procedure" followed by a terminating NULL character). The **UnalignedLpstr** (section 2.3.3.1.5) structure does not require padding. Therefore, in this example, even though 19 is not a multiple of 4 bytes, no padding is added to the value field. **UnalignedLpstr Vector.rgString.LpstrElement-2.value:** "Approval Procedure" is the value of the **value** field of this **UnalignedLpstr** (section 2.3.3.1.5). The rest of the **UnalignedLpstr** (section 2.3.3.1.5) structures in this example have the same format as the Vector.rgString.LpstrElement-2 structure defined previous. #### HeadingPairs Property Example This is an example of a **HeadingPairs** property ([**VtVecHeadingPair**](#Section_3aaaf9e84f1a42fa9359fe0ab0c1cccc) property (section 2.3.3.1.15)). | **Offset** | **Size** | **Structure** | **Value** | |----|----|----|----| | 00000261 | 0037 | TypedPropertyValue **- GKPIDDSI_HEADINGPAIR** | | | 00000261 | 0002 | WORD **- wType** | 0x100C | | 00000263 | 0002 | WORD **- padding** | 0x0000 | | 00000265 | 0033 | [VtVecHeadingPairValue](#Section_7eaa201d3fe149178e393690a3a36c11) **- GKPIDDSI_HEADINGPAIR** | | | 00000265 | 0004 | DWORD **- cElements** | 0x00000004 | | 00000269 | 002F | Array of VtHeadingPair **- rgHeadingPairs** | | | 00000269 | 0016 | [VtHeadingPair](#Section_8d8db7dc9a0c4bcc9ad5a2937bb559b0) **- VtHeadingPairElement-1** | | | 00000269 | 000E | [VtUnalignedString](#Section_eb04ce67f96b4ea4adf77f75847c7abb) **- headingString** | | | 00000269 | 0002 | WORD **- stringType** | 0x001E | | 0000026B | 0002 | WORD **- padding** | 0x0000 | | 0000026D | 000A | [UnalignedLpstr](#Section_a8f75582c3d34a5bbbca62ed6a05711d) **- stringValue** | | | 0000026D | 0004 | DWORD **- cch** | 0x00000006 | | 00000271 | 0006 | Array of CHAR **- value** | Title | | 00000277 | 0008 | TypedPropertyValue **- headerParts** | | | 00000277 | 0002 | WORD **- wType** | 0x0003 | | 00000279 | 0002 | WORD **- padding** | 0x0000 | | 0000027B | 0004 | DWORD **- value** | 0x00000001 | | 0000027F | 0019 | VtHeadingPair **- VtHeadingPairElement-2** | | | 0000027F | 0011 | VtUnalignedString **- headingString** | | | 0000027F | 0002 | WORD **- stringType** | 0x001E | | 00000281 | 0002 | WORD **- padding** | 0x0000 | | 00000283 | 000D | UnalignedLpstr **- stringValue** | | | 00000283 | 0004 | DWORD **- cch** | 0x00000009 | | 00000287 | 0009 | Array of CHAR **- value** | Headings | | 00000290 | 0008 | TypedPropertyValue **- headerParts** | | | 00000290 | 0002 | WORD **- wType** | 0x0003 | | 00000292 | 0002 | WORD **- padding** | 0x0000 | | 00000294 | 0004 | DWORD **- value** | 0x00000008 | Figure 23: Structure of a HeadingPairs property The **HeadingPairs** property needs to be viewed together with the [**DocumentParts property**](#Section_742bc556d7884900b7aeb8fe1f2e4322) (section 3.2.2.5), because data in the two are closely related. See the **DocumentParts property** (section 3.2.2.5) example for more explanation. **wType:** 0x100C indicates this property is a vector of variant types. **GKPIDDSI_HEADINGPAIR.cElements:** 0x00000004 indicates there are two elements in **rgHeadingPairs**. **cElements** is twice the number of elements in **rgHeadingPairs** because each **VtHeadingPair** (section 2.3.3.1.13) element contains two values, **headingString** and **headerParts**. **GKPIDDSI_HEADINGPAIR.rgHeadingPairs:** This is a container of the array of **VtHeadingPair** (section 2.3.3.1.13). **GKPIDDSI_HEADINGPAIR.rgHeadingPairs.VtHeadingPairElement-1:** The first **VtHeadingPair** (section 2.3.3.1.13) in this array. This maps to **LpstrElement-1** of the table labeled "Structure of a DocumentParts property" in section 3.2.2.5, in the **DocumentParts** property. **GKPIDDSI_HEADINGPAIR.rgHeadingPairs.VtHeadingPairElement-1.headingString:** The **headingString** in this **VtHeadingPair** (section 2.3.3.1.13) element is an **UnalignedLpstr** (section 2.3.3.1.5) structure. The **value** field of this structure is "Title" and indicates that the associated group in the **DocumentParts** property contains the title of this document. **GKPIDDSI_HEADINGPAIR.rgHeadingPairs.VtHeadingPairElement-1.headerParts:** The **headingParts** of this **headingPair** is a VT_I4 **TypedPropertyValue** property. The value of it is 0x00000001, meaning this **headingPair** is associated with 1 element in the **DocumentParts** property. **GKPIDDSI_HEADINGPAIR.rgHeadingPairs.VtHeadingPairElement-2:** This is the second **VtHeadingPair** (section 2.3.3.1.13) element in this vector. It conforms to the same structure as the first element but contains different data. The **value** field of **headingString** is "Headings", indicating that the associated elements in the **DocumentParts** property specify the heading of the document. The **value** field of the **headerParts** has a value of 8, meaning there are eight elements of **UnalignedLpstr** (section 2.3.3.1.5) structure in the **DocumentParts** property associated with **VtHeadingPairElement-2**. They are **LpstrElement-2** through to **LpstrElement-9** of the table labeled "Structure of a DocumentParts property" in section 3.2.2.5, in the **DocumentParts** property. ### User Defined Property Set Overview The following table contains the beginning of a [**User Defined property set**](#Section_54514afbff194348be71395854d4432d) (section 2.3.3.2.3). In this table, there is an array, **rgUserProps**. Each element in **rgUserProps** is a **PropertyIdentifierAndOffset** structure ([\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.19](http://msdn.microsoft.com/en-us/library/f59e6c94-a0ae-4d1b-85d3-f01c35779a22/)). The structure of this section of the **User Defined property set** (section 2.3.3.2.3) is similar to that described in [Document Summary Information Property Set Overview](#Section_c0e0190a08284638ab746fc190da3582) (section 3.2.2). The major difference is that in the **User Defined property set** (section 2.3.3.2.3) most **propId** values do not have a meaning defined by this specification, but instead have a meaning defined by their names as found in the [**Dictionary property**](#Section_8890a6721688463d9c0a46b5e72b5012) (section 3.2.3.1). | **Offset** | **Size** | **Structure** | **Value** | |----|----|----|----| | 00000298 | 0420 | **B**: PropertySet **- UserDefinedProperties** | | | 00000298 | 0004 | DWORD **- cbSection** | 0x00000420 | | 0000029C | 0004 | DWORD **- cProps** | 0x00000009 | | 000002A0 | 0048 | Array of PropertyIdentifierAndOffset **- rgUserProps** | | | 000002A0 | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-1** | | | 000002A0 | 0004 | DWORD **- propId** | 0x00000000 | | 000002A4 | 0004 | FilePointer **- dictionaryOffset** | 0x00000050 | | 000002A8 | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-2** | | | 000002A8 | 0004 | DWORD **- propId** | 0x00000001 | | 000002AC | 0004 | FilePointer **- codepageOffset** | 0x000000D2 | | 000002B0 | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-3** | | | 000002B0 | 0004 | DWORD **- propId** | 0x00000002 | | 000002B4 | 0004 | FilePointer **- linkbaseOffset** | 0x000000DA | | 000002B8 | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-4** | | | 000002B8 | 0004 | DWORD **- propId** | 0x00000003 | | 000002BC | 0004 | FilePointer **- hyperlinksOffset** | 0x000000E6 | | 000002C0 | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-5** | | | 000002C0 | 0004 | DWORD **- propId** | 0x00000004 | | 000002C4 | 0004 | FilePointer **- propOffset** | 0x000003B6 | | 000002C8 | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-6** | | | 000002C8 | 0004 | DWORD **- propId** | 0x00000005 | | 000002CC | 0004 | FilePointer **- propOffset** | 0x000003CA | | 000002D0 | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-7** | | | 000002D0 | 0004 | DWORD **- propId** | 0x00000006 | | 000002D4 | 0004 | FilePointer **- propOffset** | 0x000003D2 | | 000002D8 | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-8** | | | 000002D8 | 0004 | DWORD **- propId** | 0x00000007 | | 000002DC | 0004 | FilePointer **- propOffset** | 0x000003DA | | 000002E0 | 0008 | PropertyIdentifierAndOffset **- PidOffsetElement-9** | | | 000002E0 | 0004 | DWORD **- propId** | 0x01000007 | | 000002E4 | 0004 | FilePointer **- propLinkOffset** | 0x000003FA | | 000002E8 | 03D0 | Array of properties **- UserDefinedProperties** | | Figure 24: Overview of a User Defined property set **UserDefinedProperties:** **UserDefinedProperties** is a **PropertySet** as detailed in \[MS-OLEPS\] section [2.20](http://msdn.microsoft.com/en-us/library/aefcbddf-f299-4f5e-a9da-65ce4ca55075/). **cbSection:** 0x00000420 indicates the count of bytes from the beginning of the **UserDefinedProperties** property set (0x00000298) to the end of the last property in the property set, the [**CriticalSection_Link**](#Section_6a83ba1334764be18f7fa609adbcded4) property (section 3.2.3.4). If the size is calculated as 0x0000069A + 0x001C - 0x00000298, it actually results in a size of 0x0000041E instead of 0x00000420. This is because the property set is padded to a multiple of 4 bytes. After the end of the **CriticalSection_Link** property (section 3.2.3.4) property, there are 2 bytes of padding to make the count of bytes of the property set a multiple of 4 bytes, resulting in a length of 0x00000420. **cProps:** 0x00000009 indicates that this **User Defined property set** (section 2.3.3.2.3) contains nine properties. **rgUserProps:** This is the container of an array of **PropertyIdentifierAndOffset** structures. In this example, there are nine elements, one for each property. **rgUserProps.PidOffsetElement-1:** Dictionary (**Dictionary** property). **rgUserProps.PidOffsetElement-1.propId:** 0x00000000 indicates that there is a **Dictionary** property value at the [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) offset indicated by the **dictionaryOffset** value. **rgUserProps.PidOffsetElement-1.dictionaryOffset:** 0x00000050 indicates that the beginning of the **Dictionary** property data is 0x00000050 bytes after the beginning of the **UserDefinedProperties** property set (0x00000298). In this example, the **Dictionary** property begins at offset 0x000002E8. See the **Dictionary property** example (section 3.2.3.1). **rgUserProps.PidOffsetElement-2:** CodePage (VT_I2 **TypedPropertyValue** property). **rgUserProps.PidOffsetElement-2.propId:** 0x00000001 indicates that there is a **CodePage** property value at the stream offset indicated by the **codepageOffset** value. **rgUserProps.PidOffsetElement-2.codepageOffset:** 0x000000D2 indicates that the beginning of the **CodePage** property data is 0x000000D2 bytes after the beginning of the **UserDefinedProperties** property set. **rgUserProps.PidOffsetElement-3:** User-defined property. **rgUserProps.PidOffsetElement-3.propId:** 0x00000002 indicates there is a user-defined property value at the stream offset indicated by the **linkbaseOffset** value. The name of this user-defined property is specified in the **Dictionary** property as "\_PID_LINKBASE". See the Dictionary Property Example (section 3.2.3.1). **rgUserProps.PidOffsetElement-3.linkbaseOffset:** 0x000000DA indicates the user-defined property with **propId** 0x00000002 begins 0x000000DA bytes after the beginning of the **UserDefinedProperties** property set. In this example, this property begins at offset 0x00000372. See the [LinkBase Property Example](#Section_9109a8bb3495457e9cd01955490a063f) (section 3.2.3.2). **rgUserProps.PidOffsetElement-4:** User-defined property. **rgUserProps.PidOffsetElement-4.propId:** 0x00000003 indicates there is a user-defined property value at the stream offset indicated by the **hyperlinksOffset** value. The name of this user-defined property is specified in the **Dictionary** property as "\_PID_HLINKS". See the Dictionary Property Example (section 3.2.3.1). **rgUserProps.PidOffsetElement-4.hyperlinksOffset:** 0x000000E6 indicates the user-defined property with **propId** 0x00000003 begins 0x000000E6 bytes after the beginning of the **UserDefinedProperties** property set. In this example, this property begins at offset 0x0000037E. See the [Hyperlinks Property Example](#Section_fbfec8b87db44a60bc0e5ea0b1bc2328) (section 3.2.3.3). **rgUserProps.PidOffsetElement-5:** User-defined property. **rgUserProps.PidOffsetElement-5.propId:** 0x00000004 indicates there is a user-defined property value at the stream offset indicated by the **propOffset** value. The name of this user-defined property is specified in the **Dictionary** property as "Department". See the Dictionary Property Example (section 3.2.3.1). **rgUserProps.PidOffsetElement-5.propOffset:** 0x000003B6 indicates the user-defined property with **propId** 0x00000004 begins 0x000003B6 bytes after the beginning of the **UserDefinedProperties** property set. This property is a [**Lpstr**](#Section_fac324c9ff39442ebd181a91a723a818) (section 2.3.3.1.4) property, see [Category Property Example](#Section_29d75dd8a0654c23948c8f705f01f986) (section 3.2.2.2) for an example of a **Lpstr** (section 2.3.3.1.4) property. **rgUserProps.PidOffsetElement-6:** User-defined property. **rgUserProps.PidOffsetElement-6.propId:** 0x00000005 indicates there is a user-defined property value at the stream offset indicated by the **propOffset** value. The name of this user-defined property is specified in the **Dictionary** property as "Document number". See the Dictionary Property Example (section 3.2.3.1). **rgUserProps.PidOffsetElement-6.propOffset:** 0x000003CA indicates the user-defined property with **propId** 0x00000005 begins 0x000003CA bytes after the beginning of the **UserDefinedProperties** property set. This property is a VT_I4 **TypedPropertyValue** property. See the [LineCount Property Example](#Section_c93a7a10a41945639a2ed4b4dc51cf94) (section 3.2.2.3) for an example of a VT_I4 **TypedPropertyValue** property. **rgUserProps.PidOffsetElement-7:** User-defined property. **rgUserProps.PidOffsetElement-7.propId:** 0x00000006 indicates there is a user-defined property value at the stream offset indicated by the **propOffset** value. The name of this user-defined property is specified in the **Dictionary** property as "Approved". See the Dictionary Property Example (section 3.2.3.1). **rgUserProps.PidOffsetElement-7.propOffset:** 0x000003D2 indicates the user-defined property with **propId** 0x00000006 begins 0x000003D2 bytes after the beginning of the **UserDefinedProperties** property set. This property is a VT_BOOL **TypedPropertyValue** property. See the [LinksDirty Property Example](#Section_073efdcc7d75400396a9c48f4a3ce77c) (section 3.2.2.4) for an example of a VT_BOOL **TypedPropertyValue** property. **rgUserProps.PidOffsetElement-8:** User-defined linked property. **rgUserProps.PidOffsetElement-8.propId:** 0x00000007 indicates there is a user-defined property value at the stream offset indicated by the **propOffset** value. The name of this user-defined property is specified in the **Dictionary** property as "CriticalSection". See the **Dictionary property** example (section 3.2.3.1). **rgUserProps.PidOffsetElement-8.propOffset:** 0x000003DA indicates the user-defined property with **propId** 0x00000007 begins 0x000003DA bytes after the beginning of the **UserDefinedProperties** property set. In this example, this property begins at offset 0x00000672. See the Linked Property Example (section 3.2.3.4). **rgUserProps.PidOffsetElement-9:** User-defined Link. **rgUserProps.PidOffsetElement-9.propId:** 0x01000007 indicates that the user-defined property in this property set with **propId** 0x01000007 is linked to document content. This user-defined Link value is at the stream offset indicated by the **propLinkOffset** value. See the Linked Property Example (section 3.2.3.4). **rgUserProps.PidOffsetElement-9.propLinkOffset:** 0x000003FA indicates that the user-defined property link with **propId** 0x10000007 begins 0x000003FA bytes after the beginning of the **UserDefinedProperties** property set. In this example, this property begins at offset 0x00000692. See the Linked Property Example (section 3.2.3.4). #### Dictionary Property Example This is an example of a **Dictionary** property as detailed in [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) section [2.17](http://msdn.microsoft.com/en-us/library/99127b7f-c440-4697-91a4-c853086d6b33/). This property gives a mapping between **propertyId** and **propertyName** for the [**User Defined property set**](#Section_54514afbff194348be71395854d4432d) (section 2.3.3.2.3), except for the **Dictionary** property, the **CodePage** property, and the [**Links**](#Section_6a83ba1334764be18f7fa609adbcded4) (section 3.2.3.4). In this example, there are 9 elements in the array of **PropertyIdentifierAndOffset** (**rgUserProps** of the previous table). Each element represents a property. However there are only 6 DictionaryEntry elements (\[MS-OLEPS\] section [2.16](http://msdn.microsoft.com/en-us/library/333959a3-a999-4eca-8627-48a224e63e77/)) in the **rgEntries** in the **Dictionary** property of following table. The 3 elements that are excluded are the element associated with the **Dictionary** property (**PidOffsetElement-1** in **rgUserProps**), the element associated with the **CodePage** property (**PidOffsetElement-2** in **rgUserProps**), and the element associated with the property link (**PidOffsetElement-9** in **rgUserProps**). | **Offset** | **Size** | **Structure** | **Value** | |----|----|----|----| | 000002E8 | 0082 | Dictionary **- Dictionary** | | | 000002E8 | 0004 | DWORD **- cEntries** | 0x00000006 | | 000002EC | 007E | Array of DictionaryEntry **- rgEntries** | | | 000002EC | 0016 | DictionaryEntry **- LpstrNameIdElement-1** | | | 000002EC | 0004 | DWORD **- propertyId** | 0x00000002 | | 000002F0 | 0012 | [UnalignedLpstr](#Section_a8f75582c3d34a5bbbca62ed6a05711d) **- propertyName** | | | 000002F0 | 0004 | DWORD **- cch** | 0x0000000E | | 000002F4 | 000E | Array of CHAR **- value** | \_PID_LINKBASE | | 00000302 | 0014 | DictionaryEntry **- LpstrNameIdElement-2** | | | 00000302 | 0004 | DWORD **- propertyId** | 0x00000003 | | 00000306 | 0010 | UnalignedLpstr **- propertyName** | | | 00000306 | 0004 | DWORD **- cch** | 0x0000000C | | 0000030A | 000C | Array of CHAR **- value** | \_PID_HLINKS | | 00000316 | 0013 | DictionaryEntry **- LpstrNameIdElement-3** | | | 00000316 | 0004 | DWORD **- propertyId** | 0x00000004 | | 0000031A | 000F | UnalignedLpstr **- propertyName** | | | 0000031A | 0004 | DWORD **- cch** | 0x0000000B | | 0000031E | 000B | Array of CHAR **- value** | Department | | 00000329 | 0018 | DictionaryEntry **- LpstrNameIdElement-4** | | | 00000329 | 0004 | DWORD **- propertyId** | 0x00000005 | | 0000032D | 0014 | UnalignedLpstr **- propertyName** | | | 0000032D | 0004 | DWORD **- cch** | 0x00000010 | | 00000331 | 0010 | Array of CHAR **- value** | Document number | | 00000341 | 0011 | DictionaryEntry **- LpstrNameIdElement-5** | | | 00000341 | 0004 | DWORD **- propertyId** | 0x00000006 | | 00000345 | 000D | UnalignedLpstr **- propertyName** | | | 00000345 | 0004 | DWORD **- cch** | 0x00000009 | | 00000349 | 0009 | Array of CHAR **- value** | Approved | | 00000352 | 0018 | DictionaryEntry **- LpstrNameIdElement-6** | | | 00000352 | 0004 | DWORD **- propertyId** | 0x00000007 | | 00000356 | 0014 | UnalignedLpstr **- propertyName** | | | 00000356 | 0004 | DWORD **- cch** | 0x00000010 | | 0000035A | 0010 | Array of CHAR **- value** | CriticalSection | Figure 25: Structure of a Dictionary property **cEntries:** 0x00000006 indicates there are six entries in **rgEntrie**s. **rgEntries:** This is an array of **DictionaryEntry**. The **CodePage** property value in **UserDefinedProperties** is not CP_WINUNICODE (0x04B0) so each **DictionaryEntry** contains an **UnalignedLpstr** (section 2.3.3.1.5), see \[MS-OLEPS\] section 2.16. **rgEntries.LpstrNameIdElement-1:** This is the first element in this array. **rgEntries.LpstrNameIdElement-1.propertyId:** 0x00000002 is the same as one of the **propId** elements in **rgUserProps**, which indicates that this **DictionaryEntry** corresponds to the user-defined property with **propId** 0x00000002. **rgEntries.LpstrNameIdElement-1.propertyName:** This is an **UnalignedLpstr** (section 2.3.3.1.5) structure. **rgEntries.LpstrNameIdElement-1.propertyName.cch:** 0x0000000E is the count of character value for this **UnalignedLpstr** (section 2.3.3.1.5) structure. The **cch** field in **LpstrNameIdElement-1** to **LpstrNameIdElement-6** is the count of character value for each of the **UnalignedLpstr** structures. See the [DocumentParts Property Example](#Section_742bc556d7884900b7aeb8fe1f2e4322) (section 3.2.2.5) for the structure of an **UnalignedLpstr**. **rgEntries.LpstrNameIdElement-1.propertyName.value:** "\_PID_LINKBASE" indicates the property name of the user-defined property with **propId** 0x00000002. See the [LinkBase Property Example](#Section_9109a8bb3495457e9cd01955490a063f) (section 3.2.3.2). **rgEntries.LpstrNameIdElement-2:** This is the second element in this array. **rgEntries.LpstrNameIdElement-2.propertyId:** 0x00000003 is the same as one of the **propId** elements in **rgUserProps**, which indicates that this **DictionaryEntry** corresponds to the user-defined property with **propId** 0x00000003. **rgEntries.LpstrNameIdElement-2.propertyName:** This is an **UnalignedLpstr** (section 2.3.3.1.5) structure. **rgEntries.LpstrNameIdElement-2.propertyName.value:** "\_PID_HLINKS" indicates the property name of the user-defined property with **propId** 0x00000003. See the [Hyperlinks Property Example](#Section_fbfec8b87db44a60bc0e5ea0b1bc2328) (section 3.2.3.3). **rgEntries.LpstrNameIdElement-3:** This is the third element in this array. **rgEntries.LpstrNameIdElement-3.propertyId:** 0x00000004 is the same as one of the **propId** elements in **rgUserProps**, which indicates that this **DictionaryEntry** corresponds to the user-defined property with **propId** 0x00000004. **rgEntries.LpstrNameIdElement-3.propertyName:** This is an **UnalignedLpstr** (section 2.3.3.1.5) structure. **rgEntries.LpstrNameIdElement-3.propertyName.value:** "Department" indicates the property name of the user-defined property with **propId** 0x00000004. **rgEntries.LpstrNameIdElement-4:** This is the fourth element in this array. **rgEntries.LpstrNameIdElement-4.propertyId:** 0x00000005 is the same as one of the **propId** elements in **rgUserProps**, which indicates that this **DictionaryEntry** corresponds to the user-defined property with **propId** 0x00000005. **rgEntries.LpstrNameIdElement-4.propertyName:** This is an **UnalignedLpstr** (section 2.3.3.1.5) structure. **rgEntries.LpstrNameIdElement-4.propertyName.value:** "Document number" indicates the property name of the user-defined property with **propId** 0x00000005. **rgEntries.LpstrNameIdElement-5:** This is the fifth element in this array. **rgEntries.LpstrNameIdElement-5.propertyId:** 0x00000006 is the same as one of the **propId** elements in **rgUserProps**, which indicates that this **DictionaryEntry** corresponds to the user-defined property with **propId** 0x00000006. **rgEntries.LpstrNameIdElement-5.propertyName:** This is the container for an **UnalignedLpstr** (section 2.3.3.1.5) structure. **rgEntries.LpstrNameIdElement-5.propertyName.value:** "Approved" indicates the property name of the user-defined property with **propId** 0x00000006. **rgEntries.LpstrNameIdElement-6:** This is the sixth element in this array. **rgEntries.LpstrNameIdElement-6.propertyId:** 0x00000007 is the same as one of the **propId** elements in **rgUserProps**, which indicates that this **DictionaryEntry** corresponds to the user-defined property with **propId** 0x00000007. **rgEntries.LpstrNameIdElement-6.propertyName:** This is an **UnalignedLpstr** (section 2.3.3.1.5) structure. **rgEntries.LpstrNameIdElement-6.propertyName.value:** "CriticalSection" indicates the property name of the user-defined property with **propId** 0x00000007. See the Linked Property Example (section 3.2.3.4). #### LinkBase Property Example This is an example of the **LinkBase** property (VT_BLOB **TypedPropertyValue** property). | **Offset** | **Size** | **Structure** | **Value** | |------------|----------|-----------------------------------------|------------| | 00000372 | 000A | TypedPropertyValue **- \_PID_LINKBASE** | | | 00000372 | 0002 | WORD **- wType** | 0x0041 | | 00000374 | 0002 | WORD **- padding** | 0x0000 | | 00000376 | 0004 | DWORD **- cb** | 0x00000002 | | 0000037A | 0002 | Array of WCHAR **- value** | 0x0000 | | 0000037C | 0002 | Array of bytes **- padding** | 0x0000 | Figure 26: Structure of a LinkBase property **wType:** 0x0041 indicates the property is a VT_BLOB **TypedPropertyValue** property. **cb:** 0x00000002 indicates the count of bytes of the value of this property. In this example, the **value** field contains an empty string, so 0x00000002 refers to the count of bytes of the [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) terminating NULL character. **value:** The **value** field of the property contains only a Unicode terminating NULL character. **padding:** 0x0000 is 2 bytes of padding. This padding is added so that the length of this VT_BLOB **TypedPropertyValue** property structure is a multiple of 4 bytes. #### Hyperlinks Property Example This is an example of **a [VtHyperlinks](#Section_4df4d1a8bb4746bdacd7944e817338e7)** property (section 2.3.3.1.21). There is a **rgHyperlink** vector in the property, which contains all the [**hyperlinks**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) within this sample document. | **Offset** | **Size** | **Structure** | **Value** | |----|----|----|----| | 0000037E | 02D0 | VtHyperlinks **- \_PID_HLINKS** | | | 0000037E | 0002 | WORD **- wType** | 0x0041 | | 00000380 | 0002 | WORD **- padding** | 0x0000 | | 00000382 | 02CC | [VtHyperlinkValue](#Section_f65d95215c8d4888a23ecc1b9f9d7da5) **- vtValue** | | | 00000382 | 0004 | DWORD **- cbData** | 0x000002C8 | | 00000386 | 02C8 | [VecVtHyperlink](#Section_754880cc03d448e794fcd9f6573f11af) **- vecHyperlink** | | | 00000386 | 0004 | DWORD **- cElements** | 0x00000024 | | 0000038A | 02C4 | Array of VtHyperlink **- rgHyperlink** | | | 0000038A | 006C | [VtHyperlink](#Section_2225d544e06344ff9f70739f1c14d592) **- linkElement-1** | | | 000003F6 | 0074 | VtHyperlink **- linkElement-2** | | | 0000046A | 006C | VtHyperlink **- linkElement-3** | | | 000004D6 | 005C | VtHyperlink **- linkElement-4** | | | 00000532 | 00B4 | VtHyperlink **- linkElement-5** | | | 000005E6 | 0068 | VtHyperlink **- linkElement-6** | | Figure 27: Structure of a Hyperlinks property **wType:** 0x0041 indicates the property is of VT_BLOB **TypedPropertyValue** property. **vtValue.cbData:** 0x000002C8 indicates the count of bytes of the **vecHyperlink** field. In this example, it is 0x000005E6 + 0x0068 – 0x00000386 = 0x000002C8. **vtValue.vecHyperlink.cElements:** 0x00000024 indicates there are six **VtHyperlink** structures (section 2.3.3.1.18) in this array. The number of elements is 1/6 of the value of **cElements** property as each **VtHyperlink** element (section 2.3.3.1.18) contains six values. **vtValue.vecHyperlink.rgHyperlink:** This is a vector of **VtHyperlink** structures (section 2.3.3.1.21). **vtValue.vecHyperlink.rgHyperlink.linkElement-1:** See the [LinkElement-3.2.3.3.1 Example](#Section_37a17baf223446bc95d4cd0ad42735f6) (section 3.2.3.3.1) for the structure of this **VtHyperlink** (section 2.3.3.1.18). The 6 **linkElements** here share the same structure and are described in the following sections. ##### LinkElement-1 Example This is an example of a **linkElement** which consists of 6 structures: **dwHash**, **dwApp**, **dwOfficeArt**, **dwInfo**, **hlink1**, and **hlink2**. The values of **dwApp**, **dwOfficeArt**, and **dwInfo** define where the [**hyperlink**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) is applied. The hyperlink can be applied to a shape, a picture in the document, an external link to a picture, or other content in the documents. The values of **hlink1** and **hlink2** define where the hyperlink links. The hyperlink can point to a specific item (for example, a bookmark or a heading) within the same document, or an external file, or an external site, or a specific item in the external site or file. **dwHash** is the calculated value of the [**Hyperlink Hash**](#Section_beb6ef90fb234c9f9d3acf1d68616441) (section 2.4.2) algorithm with the values of **hlink1** and **hlink2** as inputs. | **Offset** | **Size** | **Structure** | **Value** | |----|----|----|----| | 0000038A | 006C | [VtHyperlink](#Section_2225d544e06344ff9f70739f1c14d592) **- linkElement-1** | | | 0000038A | 0008 | TypedPropertyValue **- dwHash** | | | 0000038A | 0002 | WORD **- wType** | 0x0003 | | 0000038C | 0002 | WORD **- padding** | 0x0000 | | 0000038E | 0004 | DWORD **- value** | 0x00670069 | | 00000392 | 0008 | TypedPropertyValue **- dwApp** | | | 00000392 | 0002 | WORD **- wType** | 0x0003 | | 00000394 | 0002 | WORD **- padding** | 0x0000 | | 00000396 | 0004 | DWORD **- value** | 0x0000000C | | 0000039A | 0008 | TypedPropertyValue **- dwOfficeArt** | | | 0000039A | 0002 | WORD **- wType** | 0x0003 | | 0000039C | 0002 | WORD **- padding** | 0x0000 | | 0000039E | 0004 | DWORD **- value** | 0x00000000 | | 000003A2 | 0008 | TypedPropertyValue **- dwInfo** | | | 000003A2 | 0002 | WORD **- wType** | 0x0003 | | 000003A4 | 0002 | WORD **- padding** | 0x0000 | | 000003A6 | 0004 | DWORD **- value** | 0x00000005 | | 000003AA | 000C | TypedPropertyValue **- hlink1** | | | 000003AA | 0002 | WORD **- wType** | 0x001F | | 000003AC | 0002 | WORD **- padding** | 0x0000 | | 000003AE | 0008 | [Lpwstr](#Section_e5f5c0973b4440f293ccab4ce521f82d) **- vtValue** | | | 000003AE | 0004 | DWORD **- cch** | 0x00000001 | | 000003B2 | 0002 | Array of WCHAR **- value** | | | 000003B4 | 0002 | Array of bytes **- padding** | | | 000003B4 | 0001 | BYTE **- paddingByte-1** | 0x79 | | 000003B5 | 0001 | BYTE **- paddingByte-2** | 0x32 | | 000003B6 | 0040 | TypedPropertyValue **- hlink2** | | | 000003B6 | 0002 | WORD **- wType** | 0x001F | | 000003B8 | 0002 | WORD **- padding** | 0x0000 | | 000003BA | 003C | Lpwstr **- vtValue** | | | 000003BA | 0004 | DWORD **- cch** | 0x0000001B | | 000003BE | 0036 | Array of WCHAR **- value** | SkipLevelVerificationStart | | 000003F4 | 0002 | Array of bytes **- padding** | | | 000003F4 | 0001 | BYTE **- paddingByte-1** | 0x00 | | 000003F5 | 0001 | BYTE **- paddingByte-2** | 0x00 | Figure 28: LinkElement example 1 **linkElement-1:** This is a hyperlink that is applied to text content in the document and that links to a bookmark in the same document. **dwHash:** The **value** field of this structure is described in Hyperlink Hash (section 2.4.2). **dwApp:** In this example, the hyperlink is not applied on a shape or a picture or an external link to a picture in this document. Therefore, the value of the **dwApp** structure is an index into a **PlcFld** ([\[MS-DOC\]](%5bMS-DOC%5d.pdf#Section_ccd7b4867881484ca13751170af7cc22) section 2.8.35) that corresponds to the beginning character of the hyperlink field in the document content. The algorithm to determine the value of **dwApp** for this example is described in \[MS-DOC\] section 2.4.7. **dwOfficeArt:** This hyperlink is not applied to a shape, so the **value** field of this structure is 0x00000000. **dwInfo:** The **value** field of this structure is 0x00000005 as the hyperlink is not applied to a shape and is in a document file as specified by \[MS-DOC\]. **hlink1:** This is the [**hyperlink target**](#gt_8ab050fe-a310-4912-ba19-859186089962). The **value** field of this structure is an empty string as this hyperlink target is the document itself. **hlink2:** This is the [**hyperlink location**](#gt_8b9cd56d-fa77-4360-a03f-9a2d5b5e0ff9). In this example, the **value** field of the structure, "SkipLevelVerificationStart", is the bookmark in the document that this hyperlink links to. **hlink2.wType:** 0x001F indicates that **vtValue** is an **Lpwstr** (section 2.3.3.1.6). **hlink2.vtValue.cch:** 0x0000001B indicates the count of characters of the **value** field of the property. 0x0000001B (27) is the count of characters of "SkipLevelVerificationStart" (26) plus the terminating NULL character (1). **hlink2.vtValue.value:** The value of this field is the [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string "SkipLevelVerificationStart" followed by a terminating NULL character. **hlink2.vtValue.padding:** This field adds 2 bytes of padding so that the total length of the **Lpwstr** structure (section 2.3.3.1.6) is a multiple of 4 bytes. ##### LinkElement-2 Example This is an example of a **linkElement** that illustrates a [**hyperlink**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) to a document other than the document that contains the link. | **Offset** | **Size** | **Structure** | **Value** | |----|----|----|----| | 000003F6 | 0074 | [VtHyperlink](#Section_2225d544e06344ff9f70739f1c14d592) **- linkElement-2** | | | 000003F6 | 0008 | TypedPropertyValue **- dwHash** | | | 000003F6 | 0002 | WORD **- wType** | 0x0003 | | 000003F8 | 0002 | WORD **- padding** | 0x0000 | | 000003FA | 0004 | DWORD **- value** | 0x003C0014 | | 000003FE | 0008 | TypedPropertyValue **- dwApp** | | | 000003FE | 0002 | WORD **- wType** | 0x0003 | | 00000400 | 0002 | WORD **- padding** | 0x0000 | | 00000402 | 0004 | DWORD **- value** | 0x00000009 | | 00000406 | 0008 | TypedPropertyValue **- dwOfficeArt** | | | 00000406 | 0002 | WORD **- wType** | 0x0003 | | 00000408 | 0002 | WORD **- padding** | 0x0000 | | 0000040A | 0004 | DWORD **- value** | 0x00000000 | | 0000040E | 0008 | TypedPropertyValue **- dwInfo** | | | 0000040E | 0002 | WORD **- wType** | 0x0003 | | 00000410 | 0002 | WORD **- padding** | 0x0000 | | 00000412 | 0004 | DWORD **- value** | 0x00000005 | | 00000416 | 0048 | TypedPropertyValue **- hlink1** | | | 00000416 | 0002 | WORD **- wType** | 0x001F | | 00000418 | 0002 | WORD **- padding** | 0x0000 | | 0000041A | 0044 | [Lpwstr](#Section_e5f5c0973b4440f293ccab4ce521f82d) **- vtValue** | | | 0000041A | 0004 | DWORD **- cch** | 0x0000001F | | 0000041E | 003E | Array of WCHAR **- value** | C:\MicrosoftOfficeOrgChart.vsd | | 0000045C | 0002 | Array of bytes **- padding** | | | 0000045C | 0001 | BYTE **- paddingByte** | 0x00 | | 0000045D | 0001 | BYTE **- paddingByte** | 0x00 | | 0000045E | 000C | TypedPropertyValue **- hlink2** | | | 0000045E | 0002 | WORD **- wType** | 0x001F | | 00000460 | 0002 | WORD **- padding** | 0x0000 | | 00000462 | 0008 | Lpwstr **- vtValue** | | | 00000462 | 0004 | DWORD **- cch** | 0x00000001 | | 00000466 | 0002 | Array of WCHAR **- value** | | | 00000468 | 0002 | Array of bytes **- padding** | | | 00000468 | 0001 | BYTE **- paddingByte** | 0x79 | | 00000469 | 0001 | BYTE **- paddingByte** | 0x32 | Figure 29: LinkElement example 2 **linkElement-2:** This is a hyperlink applied to text content in the document and links to an external file. **dwHash:** The **value** field of this structure is calculated as specified in the [**Hyperlink Hash**](#Section_beb6ef90fb234c9f9d3acf1d68616441) (section 2.4.2). **dwApp:** In this example, the hyperlink is not applied on a shape or a picture or an external link to a picture in this document. Therefore, the value of the **dwApp** structure is an index into a **PlcFld** ([\[MS-DOC\]](%5bMS-DOC%5d.pdf#Section_ccd7b4867881484ca13751170af7cc22) section 2.8.35) that corresponds to the beginning character of the hyperlink field in the document content. The algorithm to determine the value of **dwApp** for this example is described in \[MS-DOC\] section 2.4.7. **dwOfficeArt:** This hyperlink is not applied to a shape, so the **value** field of this structure is 0x00000000. **dwInfo:** The **value** field of this structure is 0x00000005 as the hyperlink is not applied to a shape and it is in a document specified by \[MS-DOC\]. **hlink1:** This is the [**hyperlink target**](#gt_8ab050fe-a310-4912-ba19-859186089962). The **value** field of this structure is "C:\MicrosoftOfficeOrgChart.vsd" indicating the name of the file that the hyperlink links to. **hlink2:** This is the [**hyperlink location**](#gt_8b9cd56d-fa77-4360-a03f-9a2d5b5e0ff9). The **value** field of the structure is an empty string because the hyperlink is not referring to a specific item within that file. ##### LinkElement-3 Example This is an example of a **linkElement** that illustrates a [**hyperlink**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) to a web resource outside of the document that contains the link. | **Offset** | **Size** | **Structure** | **Value** | |----|----|----|----| | 0000046A | 006C | [VtHyperlink](#Section_2225d544e06344ff9f70739f1c14d592) **- linkElement-3** | | | 0000046A | 0008 | TypedPropertyValue **- dwHash** | | | 0000046A | 0002 | WORD **- wType** | 0x0003 | | 0000046C | 0002 | WORD **- padding** | 0x0000 | | 0000046E | 0004 | DWORD **- value** | 0x00320064 | | 00000472 | 0008 | TypedPropertyValue **- dwApp** | | | 00000472 | 0002 | WORD **- wType** | 0x0003 | | 00000474 | 0002 | WORD **- padding** | 0x0000 | | 00000476 | 0004 | DWORD **- value** | 0x00000006 | | 0000047A | 0008 | TypedPropertyValue **- dwOfficeArt** | | | 0000047A | 0002 | WORD **- wType** | 0x0003 | | 0000047C | 0002 | WORD **- padding** | 0x0000 | | 0000047E | 0004 | DWORD **- value** | 0x00000000 | | 00000482 | 0008 | TypedPropertyValue **- dwInfo** | | | 00000482 | 0002 | WORD **- wType** | 0x0003 | | 00000484 | 0002 | WORD **- padding** | 0x0000 | | 00000486 | 0004 | DWORD **- value** | 0x00000005 | | 0000048A | 0040 | TypedPropertyValue **- hlink1** | | | 0000048A | 0002 | WORD **- wType** | 0x001F | | 0000048C | 0002 | WORD **- padding** | 0x0000 | | 0000048E | 003C | [Lpwstr](#Section_e5f5c0973b4440f293ccab4ce521f82d) **- vtValue** | | | 0000048E | 0004 | DWORD **- cch** | 0x0000001C | | 00000492 | 0038 | Array of WCHAR **- value** | http://www.wingtiptoys.com/ | | 000004CA | 000C | TypedPropertyValue **- hlink2** | | | 000004CA | 0002 | WORD **- wType** | 0x001F | | 000004CC | 0002 | WORD **- padding** | 0x0000 | | 000004CE | 0008 | Lpwstr **- vtValue** | | | 000004CE | 0004 | DWORD **- cch** | 0x00000001 | | 000004D2 | 0002 | Array of WCHAR **- value** | | | 000004D4 | 0002 | Array of bytes **- padding** | | | 000004D4 | 0001 | BYTE **- paddingByte** | 0x79 | | 000004D5 | 0001 | BYTE **- paddingByte** | 0x32 | Figure 30: LinkElement example 3 **linkElement-3:** This is a hyperlink associated with a hyperlink field applied to a picture in the document and linked to an external site. **dwHash:** The **value** field of this structure is calculated as specified in the [**Hyperlink Hash**](#Section_beb6ef90fb234c9f9d3acf1d68616441) (section 2.4.2). **dwApp:** In this example, the hyperlink is not applied on a shape or a picture or an external link to a picture in this document. Therefore, the value of the **dwApp** structure is an index into a **PlcFld** ([\[MS-DOC\]](%5bMS-DOC%5d.pdf#Section_ccd7b4867881484ca13751170af7cc22) section 2.8.35) that corresponds to the beginning character of the hyperlink field in the document content. The algorithm to determine the value of **dwApp** for this example is described in \[MS-DOC\] section 2.4.7. **dwOfficeArt:** This hyperlink is not applied to a shape, so the **value** field of this structure is 0x00000000. **dwInfo:** The **value** field of this structure is 0x00000005 as the hyperlink is not applied to a shape and it is in a document specified by \[MS-DOC\]. **hlink1:** This is the [**hyperlink target**](#gt_8ab050fe-a310-4912-ba19-859186089962). The **value** field of this structure is "http://www.wingtiptoys.com/" specifying the site that the hyperlink links to. **hlink2:** This is the [**hyperlink location**](#gt_8b9cd56d-fa77-4360-a03f-9a2d5b5e0ff9). The **value** field of the structure is an empty string because the hyperlink is not referring to a specific item within that hyperlink target. ##### LinkElement-4 Example This is an example of a **linkElement** that illustrates a [**hyperlink**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) to a header inside of the document that contains the link. | **Offset** | **Size** | **Structure** | **Value** | |----|----|----|----| | 000004D6 | 005C | [VtHyperlink](#Section_2225d544e06344ff9f70739f1c14d592) **- linkElement-4** | | | 000004D6 | 0008 | TypedPropertyValue **- dwHash** | | | 000004D6 | 0002 | WORD **- wType** | 0x0003 | | 000004D8 | 0002 | WORD **- padding** | 0x0000 | | 000004DA | 0004 | DWORD **- value** | 0x0041004A | | 000004DE | 0008 | TypedPropertyValue **- dwApp** | | | 000004DE | 0002 | WORD **- wType** | 0x0003 | | 000004E0 | 0002 | WORD **- padding** | 0x0000 | | 000004E2 | 0004 | DWORD **- value** | 0x00000003 | | 000004E6 | 0008 | TypedPropertyValue **- dwOfficeArt** | | | 000004E6 | 0002 | WORD **- wType** | 0x0003 | | 000004E8 | 0002 | WORD **- padding** | 0x0000 | | 000004EA | 0004 | DWORD **- value** | 0x00000000 | | 000004EE | 0008 | TypedPropertyValue **- dwInfo** | | | 000004EE | 0002 | WORD **- wType** | 0x0003 | | 000004F0 | 0002 | WORD **- padding** | 0x0000 | | 000004F2 | 0004 | DWORD **- value** | 0x00000005 | | 000004F6 | 000C | TypedPropertyValue **- hlink1** | | | 000004F6 | 0002 | WORD **- wType** | 0x001F | | 000004F8 | 0002 | WORD **- padding** | 0x0000 | | 000004FA | 0008 | [Lpwstr](#Section_e5f5c0973b4440f293ccab4ce521f82d) **- vtValue** | | | 000004FA | 0004 | DWORD **- cch** | 0x00000001 | | 000004FE | 0002 | Array of WCHAR **- value** | | | 00000500 | 0002 | Array of bytes **- padding** | | | 00000500 | 0001 | BYTE **- paddingByte** | 0x79 | | 00000501 | 0001 | BYTE **- paddingByte** | 0x32 | | 00000502 | 0030 | TypedPropertyValue **- hlink2** | | | 00000502 | 0002 | WORD **- wType** | 0x001F | | 00000504 | 0002 | WORD **- padding** | 0x0000 | | 00000506 | 002C | Lpwstr **- vtValue** | | | 00000506 | 0004 | DWORD **- cch** | 0x00000014 | | 0000050A | 0028 | Array of WCHAR **- value** | \_Verification_Steps | Figure 31: LinkElement example 4 **linkElement-4:** This is a hyperlink applied to text content in the document and linked to a heading section in the same document. **dwHash:** The **value** field of this structure is calculated as specified in the [**Hyperlink Hash**](#Section_beb6ef90fb234c9f9d3acf1d68616441) (section 2.4.2). **dwApp:** In this example, the hyperlink is not applied on a shape or a picture or an external link to a picture in this document. Therefore, the value of the **dwApp** structure is an index into a **PlcFld** ([\[MS-DOC\]](%5bMS-DOC%5d.pdf#Section_ccd7b4867881484ca13751170af7cc22) section 2.8.35) that corresponds to the beginning character of the hyperlink field in the document content. The algorithm to determine the value of **dwApp** for this example is described in \[MS-DOC\] section 2.4.7. **dwOfficeArt:** This hyperlink is not applied to a shape, so the **value** field of this structure is 0x00000000. **dwInfo:** The **value** field of this structure is 0x00000005 as the hyperlink is not applied to a shape and it is in a document specified by \[MS-DOC\]. **hlink1:** This is the [**hyperlink target**](#gt_8ab050fe-a310-4912-ba19-859186089962). The **value** field of this structure is an empty string as the hyperlink target is the document itself. **hlink2:** This is the [**hyperlink location**](#gt_8b9cd56d-fa77-4360-a03f-9a2d5b5e0ff9). The **value** field of the structure, "\_Verification_Steps", is the heading in this document that this hyperlink links to. ##### LinkElement-5 Example This is an example of a **linkElement** that illustrates a [**hyperlink**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) to a web resource outside of the document that contains the link, along with an anchor value within that web resource. | **Offset** | **Size** | **Structure** | **Value** | |----|----|----|----| | 00000532 | 00B4 | [VtHyperlink](#Section_2225d544e06344ff9f70739f1c14d592) **- linkElement-5** | | | 00000532 | 0008 | TypedPropertyValue **- dwHash** | | | 00000532 | 0002 | WORD **- wType** | 0x0003 | | 00000534 | 0002 | WORD **- padding** | 0x0000 | | 00000536 | 0004 | DWORD **- value** | 0x0025003E | | 0000053A | 0008 | TypedPropertyValue **- dwApp** | | | 0000053A | 0002 | WORD **- wType** | 0x0003 | | 0000053C | 0002 | WORD **- padding** | 0x0000 | | 0000053E | 0004 | DWORD **- value** | 0x00000000 | | 00000542 | 0008 | TypedPropertyValue **- dwOfficeArt** | | | 00000542 | 0002 | WORD **- wType** | 0x0003 | | 00000544 | 0002 | WORD **- padding** | 0x0000 | | 00000546 | 0004 | DWORD **- value** | 0x00000000 | | 0000054A | 0008 | TypedPropertyValue **- dwInfo** | | | 0000054A | 0002 | WORD **- wType** | 0x0003 | | 0000054C | 0002 | WORD **- padding** | 0x0000 | | 0000054E | 0004 | DWORD **- value** | 0x00000005 | | 00000552 | 006C | TypedPropertyValue **- hlink1** | | | 00000552 | 0002 | WORD **- wType** | 0x001F | | 00000554 | 0002 | WORD **- padding** | 0x0000 | | 00000556 | 0068 | [Lpwstr](#Section_e5f5c0973b4440f293ccab4ce521f82d) **- vtValue** | | | 00000556 | 0004 | DWORD **- cch** | 0x00000031 | | 0000055A | 0062 | Array of WCHAR **- value** | http://en.adatum.com/accounting/managerlist.html | | 000005BC | 0002 | Array of bytes **- padding** | | | 000005BC | 0001 | BYTE **- paddingByte** | 0x00 | | 000005BD | 0001 | BYTE **- paddingByte** | 0x00 | | 000005BE | 0028 | TypedPropertyValue **- hlink2** | | | 000005BE | 0002 | WORD **- wType** | 0x001F | | 000005C0 | 0002 | WORD **- padding** | 0x0000 | | 000005C2 | 0024 | Lpwstr **- vtValue** | | | 000005C2 | 0004 | DWORD **- cch** | 0x0000000F | | 000005C6 | 001E | Array of WCHAR **- value** | emailAddresses | | 000005E4 | 0002 | Array of bytes **- padding** | | | 000005E4 | 0001 | BYTE **- paddingByte** | 0x00 | | 000005E5 | 0001 | BYTE **- paddingByte** | 0x00 | Figure 32: LinkElement example 5 **linkElement-5:** This is a hyperlink applied to text content in the document and linked to a bookmark on an external site. **dwHash:** The **value** field of this structure is calculated as specified in the [**Hyperlink Hash**](#Section_beb6ef90fb234c9f9d3acf1d68616441) (section 2.4.2). **dwApp:** In this example, the hyperlink is not applied on a shape or a picture or an external link to a picture in this document. Therefore, the value of the **dwApp** structure is an index into a **PlcFld** ([\[MS-DOC\]](%5bMS-DOC%5d.pdf#Section_ccd7b4867881484ca13751170af7cc22) section 2.8.35) that corresponds to the beginning character of the hyperlink field in the document content. The algorithm to determine the value of **dwApp** for this example is described in \[MS-DOC\] section 2.4.7. **dwOfficeArt:** This hyperlink is not applied to a shape, so the **value** field of this structure is 0x00000000. **dwInfo:** The **value** field of this structure is 0x00000005 as the hyperlink is not applied to a shape and it is in a document specified by \[MS-DOC\]. **hlink1:** This is the [**hyperlink target**](#gt_8ab050fe-a310-4912-ba19-859186089962). The **value** field of this structure is "http://en.adatum.com/accounting/managerlist.html" indicating the site that the hyperlink links to. **hlink2:** This is the [**hyperlink location**](#gt_8b9cd56d-fa77-4360-a03f-9a2d5b5e0ff9). The **value** field of the structure, "emailAddresses", is the anchor in the target site that this hyperlink links to. ##### LinkElement-6 Example This is an example of a **linkElement** that illustrates a [**hyperlink**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) located on a shape embedded in the document to a header within the document that contains the link. | **Offset** | **Size** | **Structure** | **Value** | |----|----|----|----| | 000005E6 | 0068 | [VtHyperlink](#Section_2225d544e06344ff9f70739f1c14d592) **- linkElement-6** | | | 000005E6 | 0008 | TypedPropertyValue **- dwHash** | | | 000005E6 | 0002 | WORD **- wType** | 0x0003 | | 000005E8 | 0002 | WORD **- padding** | 0x0000 | | 000005EA | 0004 | DWORD **- value** | 0x006B0028 | | 000005EE | 0008 | TypedPropertyValue **- dwApp** | | | 000005EE | 0002 | WORD **- wType** | 0x0003 | | 000005F0 | 0002 | WORD **- padding** | 0x0000 | | 000005F2 | 0004 | DWORD **- value** | 0xFFFFFFFF | | 000005F6 | 0008 | TypedPropertyValue **- dwOfficeArt** | | | 000005F6 | 0002 | WORD **- wType** | 0x0003 | | 000005F8 | 0002 | WORD **- padding** | 0x0000 | | 000005FA | 0004 | DWORD **- value** | 0x00000402 | | 000005FE | 0008 | TypedPropertyValue **- dwInfo** | | | 000005FE | 0002 | WORD **- wType** | 0x0003 | | 00000600 | 0002 | WORD **- padding** | 0x0000 | | 00000602 | 0004 | DWORD **- value** | 0x00000004 | | 00000606 | 000C | TypedPropertyValue **- hlink1** | | | 00000606 | 0002 | WORD **- wType** | 0x001F | | 00000608 | 0002 | WORD **- padding** | 0x0000 | | 0000060A | 0008 | [Lpwstr](#Section_e5f5c0973b4440f293ccab4ce521f82d) **- vtValue** | | | 0000060A | 0004 | DWORD **- cch** | 0x00000001 | | 0000060E | 0002 | Array of WCHAR **- value** | | | 00000610 | 0002 | Array of bytes **- padding** | | | 00000610 | 0001 | BYTE **- paddingByte** | 0x79 | | 00000611 | 0001 | BYTE **- paddingByte** | 0x32 | | 00000612 | 003C | TypedPropertyValue **- hlink2** | | | 00000612 | 0002 | WORD **- wType** | 0x001F | | 00000614 | 0002 | WORD **- padding** | 0x0000 | | 00000616 | 0038 | Lpwstr **- vtValue** | | | 00000616 | 0004 | DWORD **- cch** | 0x00000019 | | 0000061A | 0032 | Array of WCHAR **- value** | \_Skip-level_Verification | | 0000064C | 0002 | Array of bytes **- padding** | | | 0000064C | 0001 | BYTE **- paddingByte** | 0x00 | | 0000064D | 0001 | BYTE **- paddingByte** | 0x00 | Figure 33: LinkElement example 6 **linkElement-6:** This is a hyperlink applied to a shape in the document and linked to a heading section within the same document. **dwHash:** The **value** field of this structure is calculated as specified in the [**Hyperlink Hash**](#Section_beb6ef90fb234c9f9d3acf1d68616441) (section 2.4.2). **dwApp:** The **value** field of this structure is 0xFFFFFFFF as the hyperlink is applied to a shape. **dwOfficeArt:** The **value** field of this structure is 0x00000402. It indicates the identifier of the shape to which the hyperlink is applied. **dwInfo:** The **value** field of this structure is 0x00000004 because the hyperlink is applied to a shape as defined in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) section 2.5.1. **hlink1:** This is the [**hyperlink target**](#gt_8ab050fe-a310-4912-ba19-859186089962). The **value** field of this structure is an empty string when the hyperlink target is the document itself. **hlink2:** This is the [**hyperlink location**](#gt_8b9cd56d-fa77-4360-a03f-9a2d5b5e0ff9). The **value** field of the structure, "\_Skip-level_Verification", is the heading in this document that this hyperlink links to. #### Linked Property Example The following table illustrates the value property of a link/value property pair that defines a [**Linked Property**](#Section_97ac7ca64fab4fb582527bb52a36fde2) (section 2.3.3.2.3.3). | **Offset** | **Size** | **Structure** | **Value** | |----|----|----|----| | 00000672 | 0020 | TypedPropertyValue **- CriticalSection** | | | 00000672 | 0002 | WORD **- wType** | 0x001E | | 00000674 | 0002 | WORD **- padding** | 0x0000 | | 00000676 | 001C | [Lpstr](#Section_fac324c9ff39442ebd181a91a723a818) **- stringValue** | | | 00000676 | 0004 | DWORD **- cch** | 0x00000018 | | 0000067A | 0018 | Array of CHAR **- value** | Sign the approval form | Figure 34: Structure of the CriticalSection property The **CriticalSection** property is an **Lpstr** property (section 2.3.3.1.4), see [Category Property Example](#Section_29d75dd8a0654c23948c8f705f01f986) (section 3.2.2.2). The **value** field of **CriticalSection** has been populated with the string contained by the bookmark specified in **CriticalSection_Link**. The following table illustrates the link property of a link/value property pair that defines a **Linked Property** (section 2.3.3.2.3.3). | **Offset** | **Size** | **Structure** | **Value** | |----|----|----|----| | 00000692 | 0024 | [VtString](#Section_60485cf2d8d94a7f99b1d1cf275ae83c) **- CriticalSection_Link** | | | 00000692 | 0002 | WORD **- stringType** | 0x001E | | 00000694 | 0002 | WORD **- padding** | 0x0000 | | 00000696 | 0020 | Lpstr **- stringValue** | | | 00000696 | 0004 | DWORD **- cch** | 0x0000001C | | 0000069A | 001C | Array of CHAR **- value** | SkipLevelVerificationStart | Figure 35: Structure of the CriticalSection_Link property The **CriticalSection_Link** property is an **Lpstr** property (section 2.3.3.1.4), see Category Property Example (section 3.2.2.2). The **value** field of **CriticalSection_Link** is a bookmark in the document content of the containing document file. The value contained in this bookmark is stored in the **CriticalSection** property. The previous two tables have **propId** values of 0x00000007 and 0x01000007 in **rgUserProps**, see [UserDefined Property Set Overview](#Section_283eeaa13610403da42032c8a16945e0) (section 3.2.3). Taken together they are an example of a **Linked Property** (section 2.3.3.2.3.3). The table with **propID** 0x01000007 (**CriticalSection_Link**) stores the name of the bookmark. The table with **propID** 0x00000007 (**CriticalSection**) stores the value of the bookmark. When the example file was saved, the value of the bookmark, the name of which was saved in the **CriticalSection_Link** property, was saved in the **CriticalSection** property. ## SmartTag Examples This section contains an example about how [**smart tag**](#gt_2f57a49a-d503-4605-8798-0e53bd637609) information is embedded in the document. In the following example, two smart tags of the following types are embedded in the document: - - StocktickerDateThe following is the example for the shared data stored in the [**PropertyBagStore**](#Section_e9e83dea3953448f8cdd2392b6ba76a3) structure (section 2.3.4.1). | **Offset** | **Size** | **Structure** | **Value** | |----|----|----|----| | 0000142A | 00BA | PropertyBagStore **- propBagStore** | | | 0000142A | 0004 | ULONG **- cFactoidType** | 0x00000002 | | 0000142E | 007F | FactoidTypes **- factoidTypes** | | | 0000142E | 0043 | **A**: [FactoidType](#Section_e20c3d1400c8439b87a07cd8bc7dfdd9) **- factoidType-0** | | | 00001471 | 003C | **B**: FactoidType **- factoidType-1** | | | 000014AD | 0002 | USHORT **- cbHdr** | 0x000C | | 000014AF | 0002 | USHORT **- sVer** | 0x0100 | | 000014B1 | 0004 | ULONG **- cfactoid** | 0x089A7948 | | 000014B5 | 0004 | ULONG **- cste** | 0x00000008 | | 000014B9 | 002B | **C**: IndexedStringTable **- stringTable** | | Figure 36: PropertyBagStore structure For simplicity this structure is broken down into substructures that are explained after the following descriptions. **propBagStore:** Structure of type **PropertyBagStore** (section 2.3.4.1). **cFactoidType:** 0x00000002 specifies the number of distinct smart tag types embedded in the document. **factoidTypes:** Array of two **FactoidType** structures (section 2.3.4.2) as specified by the **cFactoidType** field. **cbHdr:** 0x000C specifies the count of total bytes, including itself and the **sVer**, **cfactoid**, and **cste** fields. **sVer:** 0x0100 specifies the version of this structure. **cfactoid:** 0x089A7948 is an arbitrary and ignored value. **cste:** 0x00000008 specifies the total number of entries in the **stringTable**. The substructures identified by label **A**, **B**, and **C** in the preceding example are shown in the table labeled "FactoidType structure for Stockticker smart tag type", the table labeled "FactoidType structure for Date smart tag type", and the table labeled "IndexedStringTable structure", respectively. | **Offset** | **Size** | **Structure** | **Value** | |----|----|----|----| | 0000142E | 0043 | **A**: FactoidType **- factoidType-0** | | | 0000142E | 0004 | ULONG **- cbFactoid** | 0x0000003F | | 00001432 | 0004 | ULONG **- id** | 0x00000001 | | 00001436 | 002C | [PBString](#Section_0f70d2f799e9485398feedfc98825792) **- rgbUri** | | | 00001436 | 15 bits | USHORT **- cch** | 0x002A | | 00001436 | 1 bit | USHORT **- fAnsiString** | 0x1 | | 00001438 | 002A | array of bytes **- rgxch** | urn:schemas-microsoft-com:office:smarttags | | 00001462 | 000D | PBString **- rgbTag** | | | 00001462 | 15 bits | USHORT **- cch** | 0x000B | | 00001462 | 1 bit | USHORT **- fAnsiString** | 0x1 | | 00001464 | 000B | array of bytes **- rgxch** | stockticker | | 0000146F | 0002 | PBString **- rgbDownLoadURL** | | | 0000146F | 15 bits | USHORT **- cch** | 0x0000 | | 0000146F | 1 bit | USHORT **- fAnsiString** | 0x1 | | 00001471 | 0000 | array of bytes **- rgxch** | | Figure 37: FactoidType structure for Stockticker smart tag type This is the first **FactoidType** structure (section 2.3.4.2) corresponding to the Stockticker smart tag type. For simplicity, detailed descriptions for the subfields **cch** and **fAnsiString** of **rgbTag** and **rgbDownloadURL** have been omitted. **cbFactoid:** 0x0000003F specifies the size of this structure excluding the **cbFactoid** field. **id:** 0x00000001 specifies the unique id (across this document) for this smart tag type. **rgbUri.cch:** 0x002A specifies the number of characters in the string pointed to by **rbgUri.rgxch**. **rgbUri.fAnsiString:** 0x1 specifies that the string pointed to by **rgbUri.rgxch** is an [**ANSI character set**](#gt_100cd8a6-5cb1-4895-9de6-e4a3c224a583) string. **rgbUri.rgxch:** "urn:schemas-microsoft-com:office:smarttags" specifies the [**XML namespace**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) [**URI**](#gt_e18af8e8-01d7-4f91-8a1e-0fb21b191f95) for this smart tag type. **rgbTag.rgxch:** "stockticker" specifies the tag name for this smart tag type. **rgbDownLoadURL.rgxch:** This field is empty because there is no download [**URL**](#gt_433a4fb7-ef84-46b0-ab65-905f5e3a80b1) specified for this particular smart tag type. | **Offset** | **Size** | **Structure** | **Value** | |----|----|----|----| | 00001471 | 003C | **B**: FactoidType **- factoidType-1** | | | 00001471 | 0004 | ULONG **- cbFactoid** | 0x00000038 | | 00001475 | 0004 | ULONG **- id** | 0x00000002 | | 00001479 | 002C | PBString **- rgbUri** | | | 00001479 | 15 bits | USHORT **- cch** | 0x002A | | 00001479 | 1 bit | USHORT **- fAnsiString** | 0x1 | | 0000147B | 002A | array of bytes **- rgxch** | urn:schemas-microsoft-com:office:smarttags | | 000014A5 | 0006 | PBString **- rgbTag** | | | 000014A5 | 15 bits | USHORT **- cch** | 0x0004 | | 000014A5 | 1 bit | USHORT **- fAnsiString** | 0x1 | | 000014A7 | 0004 | array of bytes **- rgxch** | date | | 000014AB | 0002 | PBString **- rgbDownLoadURL** | | | 000014AB | 15 bits | USHORT **- cch** | 0x0000 | | 000014AB | 1 bit | USHORT **- fAnsiString** | 0x1 | | 000014AD | 0000 | array of bytes **- rgxch** | | Figure 38: FactoidType structure for Date smart tag type This is the second **FactoidType** structure (section 2.3.4.2) corresponding to the Date smart tag type. For simplicity, detailed descriptions for all the fields except **id** have been omitted. **id:** 0x00000002 specifies the unique id (across this document) for the Date smart tag. | **Offset** | **Size** | **Structure** | **Value** | |------------|----------|---------------------------------------------|-----------| | 000014B9 | 002B | **C**: IndexedStringTable **- stringTable** | | | 000014B9 | 0004 | PBString **- stringTableEntry-0** | | | 000014B9 | 15 bits | USHORT **- cch** | 0x0002 | | 000014B9 | 1 bit | USHORT **- fAnsiString** | 0x1 | | 000014BB | 0002 | array of bytes **- rgxch** | 10 | | 000014BD | 0006 | PBString **- stringTableEntry-1** | | | 000014BD | 15 bits | USHORT **- cch** | 0x0004 | | 000014BD | 1 bit | USHORT **- fAnsiString** | 0x1 | | 000014BF | 0004 | array of bytes **- rgxch** | 2003 | | 000014C3 | 0004 | PBString **- stringTableEntry-2** | | | 000014C3 | 15 bits | USHORT **- cch** | 0x0002 | | 000014C3 | 1 bit | USHORT **- fAnsiString** | 0x1 | | 000014C5 | 0002 | array of bytes **- rgxch** | 21 | | 000014C7 | 0005 | PBString **- stringTableEntry-3** | | | 000014C7 | 15 bits | USHORT **- cch** | 0x0003 | | 000014C7 | 1 bit | USHORT **- fAnsiString** | 0x1 | | 000014C9 | 0003 | array of bytes **- rgxch** | Day | | 000014CC | 0004 | PBString **- stringTableEntry-4** | | | 000014CC | 15 bits | USHORT **- cch** | 0x0002 | | 000014CC | 1 bit | USHORT **- fAnsiString** | 0x1 | | 000014CE | 0002 | array of bytes **- rgxch** | ls | | 000014D0 | 0007 | PBString **- stringTableEntry-5** | | | 000014D0 | 15 bits | USHORT **- cch** | 0x0005 | | 000014D0 | 1 bit | USHORT **- fAnsiString** | 0x1 | | 000014D2 | 0005 | array of bytes **- rgxch** | Month | | 000014D7 | 0007 | PBString **- stringTableEntry-6** | | | 000014D7 | 15 bits | USHORT **- cch** | 0x0005 | | 000014D7 | 1 bit | USHORT **- fAnsiString** | 0x1 | | 000014D9 | 0005 | array of bytes **- rgxch** | trans | | 000014DE | 0006 | PBString **- stringTableEntry-7** | | | 000014DE | 15 bits | USHORT **- cch** | 0x0004 | | 000014DE | 1 bit | USHORT **- fAnsiString** | 0x1 | | 000014E0 | 0004 | array of bytes **- rgxch** | Year | Figure 39: IndexedStringTable structure This is an array of string table entries. For simplicity, only the detailed description for entries at indexes 1 and 7 are shown. These two entries are referred to by the Date smart tag’s [**PropertyBag**](#Section_5dbba3b5db16449ebb6286967fa7d21b) structure (section 2.3.4.3) to form a key/value pair. The descriptions for the **cch** and **fAnsiString** subfields are also omitted. **stringTableEntry-1:** String table entry at index 1. **stringTableEntry-1.rgxch:** "2003" specifies this particular string entry. **stringTableEntry-7:** String table entry at index 7. **stringTableEntry-7.rgxch:** "Year" specifies this particular string entry. The following example shows how data private to the individual smart tag is persisted. In this example, the smart tags for the following data items were embedded in the document: - - 10/21/2003MSFTThe first data item was recognized as a date by the Date smart tag, and the second data item was recognized as a stock symbol by the Stockticker smart tag. | **Offset** | **Size** | **Structure** | **Value** | |----|----|----|----| | 000014E4 | 002C | PropertyBags **- propBags** | | | 000014E4 | 0026 | PropertyBag **- propertyBag-0** | | | 000014E4 | 0002 | USHORT **- id** | 0x0002 | | 000014E6 | 0002 | USHORT **- cProp** | 0x0004 | | 000014E8 | 0002 | USHORT **- cbUnknown** | 0x0000 | | 000014EA | 0020 | Properties **- properties** | | | 000014EA | 0008 | [Property](#Section_61d78938ed384cb39c6b9f42fdd24894) **- property-0** | | | 000014EA | 0004 | ULONG **- keyIndex** | 0x00000004 | | 000014EE | 0004 | ULONG **- valueIndex** | 0x00000006 | | 000014F2 | 0008 | Property **- property-1** | | | 000014F2 | 0004 | ULONG **- keyIndex** | 0x00000005 | | 000014F6 | 0004 | ULONG **- valueIndex** | 0x00000000 | | 000014FA | 0008 | Property **- property-2** | | | 000014FA | 0004 | ULONG **- keyIndex** | 0x00000003 | | 000014FE | 0004 | ULONG **- valueIndex** | 0x00000002 | | 00001502 | 0008 | Property **- property-3** | | | 00001502 | 0004 | ULONG **- keyIndex** | 0x00000007 | | 00001506 | 0004 | ULONG **- valueIndex** | 0x00000001 | | 0000150A | 0006 | PropertyBag **- propertyBag-1** | | | 0000150A | 0002 | USHORT **- id** | 0x0001 | | 0000150C | 0002 | USHORT **- cProp** | 0x0000 | | 0000150E | 0002 | USHORT **- cbUnknown** | 0x0000 | | 00001510 | 0000 | Properties **- properties** | | Figure 40: PropertyBag structures For simplicity detailed descriptions for **propertyBag-1.cProp** and **propertyBag-1.cbUnknown** have been omitted. **propBags:** An array of **PropertyBag** (section 2.3.4.3). **propertyBag-0:** The first **PropertyBag** (section 2.3.4.3). **propertyBag-0.id:** 0x0002 specifies the **FactoidType** (section 2.3.4.2) **id**. This value maps it to the Date smart tag type as shown in the **factoidTypes.factoidType-1** field of **PropertyBag** (section 2.3.4.3). **propertyBag-0.cProp:** 0x0004 specifies the number of properties stored as part of this smart tag. **propertyBag-0.cbUnknown:** 0x0000 specifies that this field is ignored. **propertyBag-0.properties:** An array of key/value pair indexes in the **StringTable** field as shown in the preceding example. For simplicity, only the entry at index 3 is shown. **propertyBag-0.properties.property-3:** Key/value pair at index 3. The pair as shown evaluates to "Year"="2003". **propertyBag-0.properties.property-3.keyIndex:** 0x00000007 specifies index in the **stringTable** field of **PropertyBag** (section 2.3.4.3). This maps to the string "Year". **propertyBag-0.properties.property-3.valueIndex:** 0x00000001 specifies the index in the **stringTable** field of **PropertyBag** (section 2.3.4.3). This maps to the string "2003". **propertyBag-1:** The second **PropertyBag** (section 2.3.4.3). **propertyBag-1.id:** 0x0001 specifies the **FactoidType** (section 2.3.4.2) **id**. This value maps it to the Stockticker smart tag type as shown in the **factoidTypes.factoidType-0** field of the **PropertyBag** (section 2.3.4.3). **propertyBag-1.properties:** This smart tag does not have any properties. ## Visual Basic for Applications Digital Signature Example Structures This is an example of a [**Visual Basic for Applications (VBA)**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) [**digital signature**](#gt_ad0cf6e3-05c3-482d-ab0f-617f91871189) storage structure. In this example, the structure of the digital signature is for a document as specified by [\[MS-XLS\]](%5bMS-XLS%5d.pdf#Section_cd03cb5fca024934a391bb674cb8aa06). The digital signature of a document specified by [\[MS-PPT\]](%5bMS-PPT%5d.pdf#Section_6be79dde33c14c1b8ccc4b2301c08662) has the same structure as described in this example. The digital signature of a document specified by [\[MS-DOC\]](%5bMS-DOC%5d.pdf#Section_ccd7b4867881484ca13751170af7cc22) is slightly different than this example. The difference is described in [Visual Basic for Applications Digital Signature](#Section_210c866a8b2f40ad8db8874130e1383a) (section 1.3.4). | **Offset** | **Size** | **Structure** | **Value** | |----|----|----|----| | 00000120 | 0754 | [DigSigBlob](#Section_bc21c922b7ae473690aa86afb6403462) **- vbaDigSig** | | | 00000120 | 0004 | ULONG **- cb** | 0x0000074C | | 00000124 | 0004 | ULONG **- serializedPointer** | 0x00000008 | | 00000128 | 074C | [DigSigInfoSerialized](#Section_30a00273dbee422fb488f4b8430ae046) **- signatureInfo** | | | 00000128 | 0004 | DWORD **- cbSignature** | 0x000003E4 | | 0000012C | 0004 | DWORD **- signatureOffset** | 0x0000002C | | 00000130 | 0004 | DWORD **- cbSigningCertStore** | 0x00000340 | | 00000134 | 0004 | DWORD **- certStoreOffset** | 0x00000410 | | 00000138 | 0004 | DWORD **- cbProjectName** | 0x00000000 | | 0000013C | 0004 | DWORD **- projectNameOffset** | 0x00000750 | | 00000140 | 0004 | BOOL **- fTimestamp** | 0x00000000 | | 00000144 | 0004 | DWORD **- cbTimestampUrl** | 0x00000000 | | 00000148 | 0004 | DWORD **- timestampUrlOffset** | 0x00000752 | | 0000014C | 03E4 | SignedData **- pbSignatureBuffer** | 30 82 03 E0 06 09 ... | | 00000530 | 0340 | [VBASigSerializedCertStore](#Section_e88d644c80f84016a2c093fc5b110877) **- pbSigningCertStoreBuffer** | | | 00000530 | 0004 | DWORD **- version** | 0x00000000 | | 00000534 | 0004 | DWORD **- fileType** | 0x54524543 | | 00000538 | 032C | [CertStoreCertificateGroup](#Section_462654f19be347f59c1ea6d328ac52e0) **- certGroup** | | | 00000538 | 0108 | Array of SerializedPropertyEntry **- elementList** | | | 00000538 | 0020 | [SerializedPropertyEntry](#Section_b8e9c71efe594c568419a2ed2a5858f0) **- certStorePropElement-1** | | | 00000538 | 0004 | DWORD **- id** | 0x00000014 | | 0000053C | 0004 | DWORD **- encodingType** | 0x00000001 | | 00000540 | 0004 | DWORD **- length** | 0x00000014 | | 00000544 | 0014 | Array of bytes **- value** | 3C 6B 4E A5 18 10 4F 7F 8F 6F 03 AD 5D FB D1 B5 71 1E 93 21 | | 00000558 | 00A8 | SerializedPropertyEntry **- certStorePropElement-2** | | | 00000600 | 0020 | SerializedPropertyEntry **- certStorePropElement-3** | | | 00000620 | 0020 | SerializedPropertyEntry **- certStorePropElement-4** | | | 00000640 | 0224 | [SerializedCertificateEntry](#Section_38a1970aa95e49a4bcaf6d8c10ddd5ac) **- certificateElement** | | | 00000640 | 0004 | DWORD **- id** | 0x00000020 | | 00000644 | 0004 | DWORD **- encodingType** | 0x00000001 | | 00000648 | 0004 | DWORD **- length** | 0x00000218 | | 0000064C | 0218 | Array of bytes **- certificate** | 30 82 02 14 30 82 ... | | 00000864 | 000C | [EndElementMarkerEntry](#Section_020eb66c88e3466b80f60e3ce84d0544) **- endMarkerElement** | | | 00000864 | 0004 | DWORD **- id** | 0x00000000 | | 00000868 | 0008 | Array of bytes **- marker** | 00 00 00 00 00 00 00 00 | | 00000870 | 0002 | Array of WCHAR **- rgchProjectNameBuffer** | | | 00000872 | 0002 | Array of WCHAR **- rgchTimestampBuffer** | | | 00000874 | 0000 | Array of bytes **- padding** | | Figure 41: VBA digital signature In this example, **certStorePropElement-2** through **certStorePropElement-4** have the same structure as **certStorePropElement-1**. See the certStorePropElement-1 element for details. **cb:** 0x0000074C is the count of bytes of the **signatureInfo** and **padding** fields combined. **serializedPointer:** 0x00000008 is the offset for the **signatureInfo** structure. **signatureInfo:** This is the structure that contains detailed data for the VBA digital signature. **signatureInfo.cbSignature:** 0x000003E4 is the count of bytes for the **pbSignatureBuffer** field. **signatureInfo.signatureOffset:** 0x0000002C indicates that the **pbSignatureBuffer** field begins 0x0000002C bytes after the beginning of its parent **DigSigBlob** (section 2.3.2.2). In this example, the parent **DigSigBlob** begins at offset 0x00000120. Therefore, the **pbSignatureBuffer** field begins at offset 0x0000014C. **signatureInfo.cbSigningCertStore:** 0x00000340 is the count of bytes of the **pbSigningCertStoreBuffer**. **signatureInfo.certStoreOffset:** 0x00000410 indicates that the **pbSignatureCertStoreBuffer** field begins 0x00000410 bytes after the beginning of its parent **DigSigBlob** (section 2.3.2.2). In this example, the parent **DigSigBlob** begins at offset 0x00000120. Therefore, the **pbSigningCertStoreBuffer** field begins at offset 0x00000530. **signatureInfo.cbProjectName:** 0x00000000 is the count of bytes not including the terminating NULL character of the **rgchProjectNameBuffer** field. **signatureInfo.projectNameOffset:** 0x00000750 indicates that the **rgchProjectNameBuffer** field begins 0x00000750 bytes after the beginning of its parent **DigSigBlob** (section 2.3.2.2). In this example, the parent **DigSigBlob** begins at offset 0x00000120. Therefore, the **rgchProjectNameBuffer** field begins at offset 0x00000870. **signatureInfo.fTimestamp:** 0x00000000 is a reserved value. **signatureInfo.cbTimestampUrl:** 0x00000000 is the count of bytes not including the terminating NULL character of the **rgchTimestampBuffer** field. **signatureInfo.timestampUrlOffset:** 0x00000752 indicates that the **rgchTimestampBuffer** field begins 0x00000752 bytes after the beginning of its parent **DigSigBlob** (section 2.3.2.2). In this example, the parent **DigSigBlob** begins at offset 0x00000120. Therefore, the **rgchTimestampBuffer** field begins at offset 0x00000872. **signatureInfo.pbSignatureBuffer:** The value of this field is a VBA digital signature as described in [VBA Digital Signature](#Section_7c4ce2e22a714b028f51b9f0eeed756a) (section 2.3.2.4). **signatureInfo.pbSigningCertStoreBuffer:** The value of this field is a **VBASigSerializedCertStore** structure (section 2.3.2.5.5) containing the [**digital certificate**](#gt_a1dfa70d-7803-413d-8697-c40021a3f3d0) used to create the digital signature. **signatureInfo.pbSigningCertStoreBuffer.version:** 0x00000000 indicates the version of the structure. **signatureInfo.pbSigningCertStoreBuffer.fileType:** 0x54524543 indicates that the data contained in **pbSigningCertStoreBuffer** is a digital certificate store type. **signatureInfo.pbSigningCertStoreBuffer.certGroup:** This is a container of [**digital certificate store**](#gt_d6f48603-2840-4629-a813-8ed96f69928b) elements representing a single digital certificate and a collection of properties associated with that certificate. **signatureInfo.pbSigningCertStoreBuffer.certGroup.elementList:** This is the container of an array of **SerializedPropertyEntry** (section 2.3.2.5.3). **signatureInfo.pbSigningCertStoreBuffer.certGroup.elementList.certStorePropElement-1:** This is the first element in this **SerializedPropertyEntry** (section 2.3.2.5.3) array. **signatureInfo.pbSigningCertStoreBuffer.certGroup.elementList.certStorePropElement-1.id:** 0x00000014 is the identifier of the property. **signatureInfo.pbSigningCertStoreBuffer.certGroup.elementList.certStorePropElement-1.encodingType:** 0x00000001 is a reserved value. **signatureInfo.pbSigningCertStoreBuffer.certGroup.elementList.certStorePropElement-1.length:** 0x00000014 is the count of bytes of the **value** field in this element. **signatureInfo.pbSigningCertStoreBuffer.certGroup.elementList.certStorePropElement-1.value:** The value of this field is ignored on read. **signatureInfo.pbSigningCertStoreBuffer.certGroup.certificateElement:** This is a **SerializedCertificateEntry** structure (section 2.3.2.5.1) containing the certificate stored in this digital certificate store. **signatureInfo.pbSigningCertStoreBuffer.certGroup.certificateElement.id:** 0x00000020 indicates the beginning of a **certificateElement**. **signatureInfo.pbSigningCertStoreBuffer.certGroup.certificateElement.encodingType:** 0x00000001 is a reserved value. **signatureInfo.pbSigningCertStoreBuffer.certGroup.certificateElement.length:** 0x00000218 is the count of bytes of the certificate field in this element. **signatureInfo.pbSigningCertStoreBuffer.certGroup.certificateElement.certificate:** The value of this field is the certificate data ([\[RFC3280\]](https://go.microsoft.com/fwlink/?LinkId=90414)). **signatureInfo.pbSigningCertStoreBuffer.endMarkerElement:** This is the container of a special entry in the **VBASigSerializedCertStore** structure (section 2.3.2.5.5) that marks the end of the **VBASigSerializedCertStore** structure. **signatureInfo.pbSigningCertStoreBuffer.endMarkerElement.id:** 0x00000000 is a reserved value. **signatureInfo.pbSigningCertStoreBuffer.endMarkerElement.marker:** 00 00 00 00 00 00 00 00 is the sentinel value for the end of the store. **signatureInfo.rgchProjectNameBuffer:** The value of the field is an empty string (a single null [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) character). **signatureInfo.rgchTimestampBuffer:** The value of the field is an empty string (a single null Unicode character). **padding:** The **padding** field is an array of bytes. The size of this array is the number of bytes necessary to pad the size of the **signatureInfo** field to a multiple of 4 bytes. In this example, the count of bytes of the **signatureInfo** field is 0x0000074C, a multiple of 4 bytes. Therefore, no padding is needed. # Security Considerations ## Toolbar Customization None. ## Property Set Storage None. ## Visual Basic for Applications Digital Signature The [**VBA**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) project data [**hash**](#gt_b7e2b611-0af5-4fec-8af2-3f9ce7bad205) as described in [\[MS-OVBA\]](%5bMS-OVBA%5d.pdf#Section_575462babf6741909facc275523c75fc) section 2.4.2 continues to require MD5 hash, even if the digital signing of that data uses a different algorithm. This requirement exists to support cross-version compatibility. This means that even if the [**digital signature**](#gt_ad0cf6e3-05c3-482d-ab0f-617f91871189) uses an alternate algorithm, the **digest** field of **DigestInfo** in **[SpcIndirectData](#Section_1537695a28f048288b7bd6dab62b8030)Content** (section 2.3.2.4.3.1) contains a 16-byte MD5 hash, even if the **digestAlgorithm** field of **DigestInfo** in **SpcIndirectDataContent** (section 2.3.2.4.3.1) indicates a non-MD5 digest algorithm[\<74\>](#Appendix_A_74). # 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. - - - - - - - - - - - Microsoft Office 97Microsoft Office 2000Microsoft Office XPMicrosoft Office 2003the 2007 Microsoft Office systemMicrosoft Office 2010 suitesMicrosoft Office 2013Microsoft Office 2016Microsoft Office 2019Microsoft Office 2021Microsoft Office LTSC 2024Exceptions, 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 1.5](#Appendix_A_Target_1): These persistence formats provide interoperability with applications that create or read documents conforming to this structure, including Microsoft Word 97, Microsoft Word 2000, Microsoft Word 2002, Microsoft Office Word 2003, Microsoft Excel 97, Microsoft Excel 2000, Microsoft Excel 2002, Microsoft Office Excel 2003, Microsoft PowerPoint 97, Microsoft PowerPoint 2000, Microsoft PowerPoint 2002, and Microsoft Office PowerPoint 2003. These persistence formats can also be used for interoperability with Microsoft Office Word 2007, Microsoft Word 2010, Microsoft Word 2013, Microsoft Office Excel 2007, Microsoft Excel2010, Microsoft Excel 2013, Microsoft Office PowerPoint 2007, Microsoft PowerPoint 2010, or Microsoft PowerPoint 2013 when compatibility with Word 97, Word 2000, Word 2002, Office Word 2003, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, and Office PowerPoint 2003 is a primary concern. [\<2\> Section 2.3.1.6](#Appendix_A_Target_2): In Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013, **cCL** specifies the number of [**toolbar controls**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d) in the toolbar. In Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013 **cCL** does not specify the number of toolbar controls in the [**toolbar**](#gt_c57c58f2-a71c-4dc0-ae75-471d52b62f13) and the value of **cCL** is equal to 0xFF (-1). [\<3\> Section 2.3.1.8](#Appendix_A_Target_3): In Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013, **fCtlModified** can be 0 and the toolbar can still save its toolbar controls to the file. In Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013, **fCtlModified** is equal to 1 and ignored. [\<4\> Section 2.3.1.12](#Appendix_A_Target_4): In Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013, **fNoSetCursor** is equal to 0 if the **tcid** value of the [**TBCHeader**](#Section_6fec0363d40148aaacdf46b7a8bf31db) structure that contains this structure does not equal 0x0001. In Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013, **fNoSetCursor** is equal to the appropriate value listed in [\[MS-CTXLS\]](%5bMS-CTXLS%5d.pdf#Section_b461dcd9933e471081bcdc1c74801b6b) section 2.2 if the **tcid** value of the **TBCHeader** structure that contains this structure does not equal 0x0001. [\<5\> Section 2.3.1.12](#Appendix_A_Target_5): In Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013, **fNoAccel** is equal to 0 if the **tct** value of the **TBCHeader** structure (section 2.3.1.10) that contains this structure is equal to 0x0F. Otherwise, if **tct** is not equal to 0x0F, **fNoAccel** is equal to 1. In Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013, **fNoAccel** is equal to the appropriate value listed in [\[MS-CTDOC\]](%5bMS-CTDOC%5d.pdf#Section_aff21c961b434bcf8c8a677e012c7e6a) section 2.2 if the **tcid** value of the **TBCHeader** structure that contains this structure does not equal 0x0001. [\<6\> Section 2.3.1.12](#Appendix_A_Target_6): In Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013 **fAlwaysEnabled** is equal to 0 if the **tcid** value of the **TBCHeader** structure (section 2.3.1.10) that contains this structure does not equal 0x0001. In Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013, **fAlwaysEnabled** is equal to the appropriate value listed in \[MS-CTXLS\] section 2.2 if the **tcid** value of the **TBCHeader** structure that contains this structure does not equal 0x0001. [\<7\> Section 2.3.1.12](#Appendix_A_Target_7): In Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013, **fExclusivePopup** is equal to 0. In Excel 97, and Excel 2000, **fExclusivePopup** is equal to 1 when the **tcid** field of the **TBCHeader** structure (section 2.3.1.10) that contains this structure equals 0x0001. In Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013, **fExclusivePopup** is equal to 1 when the **tcid** field of the **TBCHeader** structure that contains this structure equals 0x0001 and when the **tct** field the **TBCHeader** structure (section 2.3.1.10) that contains this structure equals one of the following values: 0x0A, 0x0B, 0x0C, 0x0D, or 0x0E. In Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013, **fExclusivePopup** is equal to 0 when the **tcid** field of the **TBCHeader** structure that contains this structure equals 1 and when the **tct** field the **TBCHeader** structure that contains this structure does not equal any of the following values: 0x0A, 0x0B, 0x0C, 0x0D, and 0x0E. In Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013, **fExclusivePopup** is equal to the appropriate value listed in \[MS-CTXLS\] section 2.2 if the **tcid** value of the **TBCHeader** structure that contains this structure does not equal 0x0001. [\<8\> Section 2.3.1.12](#Appendix_A_Target_8): In Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013, **fDefaultBehavior** is equal to 0. In Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013, **fDefaultBehavior** is equal to 0 when the **tcid** field of the **TBCHeader** structure (section 2.3.1.10) that contains this structure equals 0x0001 and is equal to 1 when the **tcid** field of the **TBCHeader** structure that contains this structure does not equal 0x0001. [\<9\> Section 2.3.1.18](#Appendix_A_Target_9): In Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013, **reserved1** is equal to 1. In Word 97, and Excel 97, **reserved1** is equal to 0 and ignored. [\<10\> Section 2.3.2.4.1](#the-digestalgorithms-field-must-contain-only-one-digestalgorithmidentifier-pkcs7-section-6.3-and-that-digestalgorithmidentifier-must-specify-the-identifier-of-the-algorithm-used-to-create-the-digest-of-the-signature.10the-contentinfo-fields-contenttype-must-be-an-object-identifier-itux680-with-the-value-1.3.6.1.4.1.311.2.1.4.-the-content-field-of-the-contentinfo-of-this-signeddata-structure-must-be-a-spcindirectdatacontent-structure-section-2.3.2.4.3.1.the-certificates-field-must-contain-certificates-as-specified-by-pkcs7-section-9.1.-this-must-include-the-signature-verification-certificate-and-can-contain-any-intermediate-certificates-between-that-end-entity-and-the-root-including-the-root.-if-the-signeddata-contains-a-countersignature-pkcs9-section-6.6-the-certificates-associated-with-the-countersignature-also-must-be-contained-in-the-certificates-field.the-crls-field-should-be-absent.-if-present-the-crls-field-must-be-ignored.the-signerinfos-field-must-contain-a-single-signerinfo-structure-section-2.3.2.4.2-pkcs7-section-9.2.signerinfo-constraints): Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 use the MD5 algorithm to create the signature digest, specified by the identifier "1.2.840.113549.2.5". [\<11\> Section 2.3.2.4.4.2](#Appendix_A_Target_11): Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 do not provide a value for the **programName** string when signing the [**VBA**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) project. However, if one is provided the applications interpret it. [\<12\> Section 2.3.2.4.4.2](#Appendix_A_Target_12): Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 omit the **moreInfo** field when signing the VBA project. However, if the field is provided, the applications interpret it. [\<13\> Section 2.3.2.5.3](#Appendix_A_Target_13): Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 write properties in the [**digital certificate store**](#gt_d6f48603-2840-4629-a813-8ed96f69928b) as a byproduct of the way the digital certificate store is constructed, but none of the properties specify any behavior and are ignored when encountered. [\<14\> Section 2.3.3](#Appendix_A_Target_14): A minimal document is not required to contain this property set storage, but all files written through a standard save operation by Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 include this property set storage. [\<15\> Section 2.3.3.1.4](#Appendix_A_Target_15): Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 do not constrain this value on write, but enforce this constraint on read. [\<16\> Section 2.3.3.1.4](#Appendix_A_Target_16): Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 write out the count of bytes including padding and the null-terminating character. [\<17\> Section 2.3.3.1.4](#Appendix_A_Target_17): The [\[MS-OLEPS\]](%5bMS-OLEPS%5d.pdf#Section_bf7aeae8c47a49399f45700158dac3bc) specification requires that padding is done with 0x00 values, but Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 write out arbitrary values for their padding in this case. [\<18\> Section 2.3.3.1.5](#Appendix_A_Target_18): Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 do not constrain this value on write, but enforce this constraint on read. [\<19\> Section 2.3.3.1.6](#Appendix_A_Target_19): Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 do not constrain this value on write, but enforce this constraint on read. [\<20\> Section 2.3.3.1.6](#Appendix_A_Target_20): The \[MS-OLEPS\] specification requires that padding is done with 0x00 values, but Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 write out arbitrary values for their padding in this case. [\<21\> Section 2.3.3.1.18](#Appendix_A_Target_21): For PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013 document content, other than [**hyperlinks**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) on shapes, the value is 0x00000007. [\<22\> Section 2.3.3.1.18](#Appendix_A_Target_22): Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013 generate this value as specified in [\[MS-DOC\]](%5bMS-DOC%5d.pdf#Section_ccd7b4867881484ca13751170af7cc22) section 2.4.7. Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 generate this value as specified in [\[MS-XLS\]](%5bMS-XLS%5d.pdf#Section_cd03cb5fca024934a391bb674cb8aa06) section 2.7.1. For PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013, the value is 0x00000006. [\<23\> Section 2.3.3.1.18](#Appendix_A_Target_23): For hyperlinks on shapes, this value is generated as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) section 2.5.1. For hyperlinks in other Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013 document content, this value is 0x00000005. For hyperlinks in other Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 document content, this value is 0x00000006. For hyperlinks in other PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013 document content, this value is 0x0000007. [\<24\> Section 2.3.3.2.1.1](#Appendix_A_Target_24): The **GKPIDSI_PAGECOUNT** property is written and interpreted by Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013 only. PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 omit the property, or preserve an existing value but ignore it. [\<25\> Section 2.3.3.2.1.1](#Appendix_A_Target_25): Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013 can write an estimate for this value. PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013 will calcuPIDSIlate an accurate value for this property on each save. [\<26\> Section 2.3.3.2.1.1](#Appendix_A_Target_26): The **GKPIDSI_WORDCOUNT** property is written and interpreted by Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013. Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 omit the property, or preserve an existing value but ignore it. [\<27\> Section 2.3.3.2.1.1](#Appendix_A_Target_27): The **GKPIDSI_CHARCOUNT** property is written and interpreted by Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013 only. PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 omit the property, or preserve an existing value but ignore it. [\<28\> Section 2.3.3.2.2.1](#Appendix_A_Target_28): The **GKPIDDSI_PRESFORMAT** property is written and interpreted by PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013 only. Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 omit the property, write an empty string for the value, or preserve a read value from an existing file but ignore it. [\<29\> Section 2.3.3.2.2.1](#Appendix_A_Target_29): Only written by PowerPoint 97, PowerPoint 2000, PowerPoint 2002, and Office PowerPoint 2003. [\<30\> Section 2.3.3.2.2.1](#Appendix_A_Target_30): Only written by Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013. [\<31\> Section 2.3.3.2.2.1](#Appendix_A_Target_31): Only written by Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013. [\<32\> Section 2.3.3.2.2.1](#Appendix_A_Target_32): Only written by Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013. [\<33\> Section 2.3.3.2.2.1](#Appendix_A_Target_33): The **GKPIDDSI_BYTECOUNT** property is written by Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013 only. Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 omit the property, or preserve an existing value but ignore it. Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013 usually omit this property or in some scenarios write a value that is inaccurate for this property, because Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013 only set or update this property when the **BuiltInDocumentProperties** property is called from the application’s document object model and do not recalculate it on save. [\<34\> Section 2.3.3.2.2.1](#Appendix_A_Target_34): The **GKPIDDSI_LINECOUNT** property is written and interpreted by Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013 only. PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 omit the property, or preserve an existing value but ignore it. [\<35\> Section 2.3.3.2.2.1](#Appendix_A_Target_35): In some cases Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013 write an estimate for this value. PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013 will calculate an accurate value for this property on each save. [\<36\> Section 2.3.3.2.2.1](#Appendix_A_Target_36): The **GKPIDDSI_PARACOUNT** property is written and interpreted by Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013. Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 omit the property, or preserve an existing value but ignore it. [\<37\> Section 2.3.3.2.2.1](#Appendix_A_Target_37): The **GKPIDDSI_SLIDECOUNT** property is written and interpreted by PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013 only. Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 omit the property, write 0, or preserve an existing value but ignore it. [\<38\> Section 2.3.3.2.2.1](#Appendix_A_Target_38): The **GKPIDDSI_NOTECOUNT** property is written and interpreted by PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013 only. Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 omit the property, write 0, or preserve an existing value but ignore it. [\<39\> Section 2.3.3.2.2.1](#Appendix_A_Target_39): The **GKPIDDSI_HIDDENCOUNT** property is written and interpreted by PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013 only. Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 omit the property, write 0, or preserve an existing value but ignore it. [\<40\> Section 2.3.3.2.2.1](#Appendix_A_Target_40): The **GKPIDDSI_MMCLIPCOUNT** property is written and interpreted by PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013 only. Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 omit the property, write 0, or preserve an existing value but ignore it. [\<41\> Section 2.3.3.2.2.1](#Appendix_A_Target_41): The **GKPIDDSI_LINKSDIRTY** property is interpreted by Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013 only. PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 write 0x00000000 for the property value. Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 will preserve an existing value but ignore it (though in the value preservation case, a nonzero value will get converted to the value 0xFFFFFFF on save). PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 fix up linked fields regardless of the state of this property. Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013 write the **GKPIDDSI_LINKSDIRTY** property as FALSE (0x00000000) because they write out updated linked property values, if applicable, in the [**User Defined Property Set**](#Section_54514afbff194348be71395854d4432d) (section 2.3.3.2.3) when saving a document. [\<42\> Section 2.3.3.2.2.1](#Appendix_A_Target_42): The **GKPIDDSI_CCHWITHSPACES** property is written and interpreted by Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013 only. PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 omit the property, or will preserve an existing value but ignore it. [\<43\> Section 2.3.3.2.2.1](#Appendix_A_Target_43): Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 write the **GKPIDDSI_HYPERLINKSCHANGED** property as FALSE because the applications write out an updated **"\_PID_HLINKS"** property, if applicable, in the User Defined Property Set (section 2.3.3.2.3) when saving a document. [\<44\> Section 2.3.3.2.2.1](#Appendix_A_Target_44): Word 97, Word 2000, Word 2002, Office Word 2003, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Excel 97, Excel 2000, Excel 2002, and Office Excel 2003 write their respective application [**minor version**](#gt_e0d99b53-9426-4a45-8429-b012184a4045) numbers as the minor version number portion of the **GKPIDDSI_VERSION** property. [\<45\> Section 2.3.3.2.2.1](#Appendix_A_Target_45): PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 use this property for storing their VBA [**digital signature**](#gt_ad0cf6e3-05c3-482d-ab0f-617f91871189). Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013 store their VBA digital signature in an unrelated location and will not write this property. Word 97, PowerPoint 97, and Excel 97 do not write digital signatures for VBA. [\<46\> Section 2.3.3.2.2.1](#Appendix_A_Target_46): Word 97, Word 2000, Word 2002, Office Word 2003, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Excel 97, Excel 2000, Excel 2002, and Office Excel 2003 do not write this property, but preserve an existing value if it already exists. Office Word 2007, Word 2010, Word 2013, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Office Excel 2007, Excel 2010, and Excel 2013 will write this property if opening a file from or saving a file to a Windows SharePoint Services document library, in which case they will write the value "document". [\<47\> Section 2.3.3.2.2.1](#Appendix_A_Target_47): Word 97, Word 2000, Word 2002, Office Word 2003, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Excel 97, Excel 2000, Excel 2002, and Office Excel 2003 do not write this property, but preserve an existing value if it already exists. [\<48\> Section 2.3.3.2.2.1](#Appendix_A_Target_48): Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 do not write this property, but preserve an existing value if it already exists. [\<49\> Section 2.3.3.2.2.1](#Appendix_A_Target_49): Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 do not write this property, but preserve an existing value if it already exists. [\<50\> Section 2.3.3.2.3.2](#Appendix_A_Target_50): Excel 97 and Word 97 write a random [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) for the **\_PID_GUID** property if the property does not yet exist. PowerPoint 97 writes a random GUID for this property on document creation only. [\<51\> Section 2.3.3.2.3.2](#Appendix_A_Target_51): The **\_MarkAsFinal** property applies only to Office Excel 2007, Excel 2010, Excel 2013, Office Word 2007, Word 2010, Word 2013, Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013. Other applications do not write this property and ignore it on read, but preserve an existing value. [\<52\> Section 2.3.3.2.3.2](#Appendix_A_Target_52): The **Microsoft Theme** property applies only to Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013. Other applications do not write this property and ignore it on read, but preserve an existing value. [\<53\> Section 2.3.3.2.3.2](#Appendix_A_Target_53): The **Presentation** property applies only to Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013. Other applications do not write this value and ignore it on read, but preserve an existing value. [\<54\> Section 2.3.3.2.3.2](#Appendix_A_Target_54): The **SlideDescription** property applies only to Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013. Other applications do not write this value and ignore it on read, but preserve an existing value. [\<55\> Section 2.3.3.2.3.2](#Appendix_A_Target_55): The **\_AllowSignedDocumentWithoutReadOnly** property applies only to Office Excel 2007, Excel 2010, Excel 2013, Office Word 2007, Word 2010, Word 2013, Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013. Previous versions of the applications ignore this property, but preserve an existing value. [\<56\> Section 2.3.3.2.3.2](#Appendix_A_Target_56): The **\_TemplateID** property applies only to Office Word 2003, Office PowerPoint 2003, Office Excel 2003, Office Word 2007, Office PowerPoint 2007, Office Excel 2007, Word 2010, Word 2013, PowerPoint 2010, PowerPoint 2013, Excel 2010, and Excel 2013. Previous versions of the applications ignore this property but preserve an existing value. [\<57\> Section 2.3.3.2.3.2](#Appendix_A_Target_57): Unless otherwise specified, these properties apply only to Office Word 2003, Office PowerPoint 2003, Office Excel 2003, Office Word 2007, Office PowerPoint 2007, Office Excel 2007, Word 2010, Word 2013, PowerPoint 2010, PowerPoint 2013, Excel 2010, and Excel 2013. Previous versions of the applications do not write these values and ignore them on read, but will preserve an existing value. [\<58\> Section 2.3.3.2.3.2](#Appendix_A_Target_58): The **\_CheckOutSrcUrl** property applies only to Office Word 2007, Office PowerPoint 2007, Office Excel 2007, Word 2010, Word 2013, PowerPoint 2010, PowerPoint 2013, Excel 2010, and Excel 2013. Previous versions of the applications do not write this value and ignore it on read, but will preserve an existing value. [\<59\> Section 2.3.3.2.3.2](#Appendix_A_Target_59): Regardless of case, "none" is considered an invalid identifier for a [**smart document**](#gt_cc9fe152-6a63-4555-91f1-1543ff84035d) solution by Office Word 2003, Office Word 2007, Word 2010, Word 2013, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013. [\<60\> Section 2.3.3.2.3.2](#Appendix_A_Target_60): Office Word 2003, Office Word 2007, Word 2010, Word 2013, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 read and write this property. Other applications do not write this value and ignore it on read, but will preserve an existing value. [\<61\> Section 2.3.3.2.3.2](#Appendix_A_Target_61): Office Word 2003, Office Word 2007, Word 2010, Word 2013, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 read and write this property. Other applications do not write this value and ignore it on read, but will preserve an existing value. [\<62\> Section 2.3.3.2.3.2](#Appendix_A_Target_62): Office Word 2003, Office Word 2007, Word 2010, and Word 2013 read and write this property. Other applications do not write this value and ignore it on read, but will preserve an existing value. [\<63\> Section 2.3.3.2.3.2](#Appendix_A_Target_63): Regardless of case, "none" is considered an invalid identifier for a solution by Office Word 2003, Office Word 2007, Word 2010, and Word 2013. [\<64\> Section 2.3.3.2.3.2](#Appendix_A_Target_64): Office Word 2003, Office Word 2007, Word 2010, and Word 2013 read and write this property. Other applications do not write this value and ignore it on read, but will preserve an existing value. [\<65\> Section 2.3.3.2.3.2](#Appendix_A_Target_65): For Office Word 2003, Office Excel 2003, Office Word 2007, Office Excel 2007, Word 2010, Word 2013, Excel 2010, and Excel 2013 documents, these solutions are generated through Visual Studio Tools for Office document [**add-in**](#gt_a3be101e-9d37-484a-a5e6-b70d559146c6) solutions. [**Managed code**](#gt_5293dd75-4296-4f8b-bb9a-cfef88c3c44d) document add-in solutions are not supported by other applications or versions. [\<66\> Section 2.3.3.2.3.2](#Appendix_A_Target_66): Office Word 2003, Office Excel 2003, Office Word 2007, Office Excel 2007, Word 2010, Word 2013, Excel 2010, and Excel 2013 interpret this property and support managed code document add-in solutions. Other applications ignore the property on read, but will preserve an existing value. [\<67\> Section 2.3.3.2.3.2](#Appendix_A_Target_67): Office Word 2003, Office Excel 2003, Office Word 2007, Office Excel 2007, Word 2010, Word 2013, Excel 2010, and Excel 2013 interpret this property and support managed code document add-in solutions. Other applications ignore the property on read, but will preserve an existing value. [\<68\> Section 2.3.3.2.3.2](#Appendix_A_Target_68): Unless otherwise specified, these properties apply only to Word 2002, PowerPoint 2002, Excel 2002, Office Word 2003, Office PowerPoint 2003, Office Excel 2003, Office Word 2007, Office PowerPoint 2007, Office Excel 2007, Word 2010, Word 2013, PowerPoint 2010, PowerPoint 2013, Excel 2010, and Excel 2013. Previous versions of the applications do not write these values and ignore them on read, but will preserve an existing value. [\<69\> Section 2.3.3.2.3.2](#Appendix_A_Target_69): Office Word 2003, Office PowerPoint 2003, Office Excel 2003, Office Word 2007, Office PowerPoint 2007, Office Excel 2007, Word 2010, Word 2013, PowerPoint 2010, PowerPoint 2013, Excel 2010, and Excel 2013 read and write this property. Previous versions of the applications do not write this value and ignore it on read, but will preserve an existing value. [\<70\> Section 2.3.3.2.3.2](#Appendix_A_Target_70): Office Word 2003, Office PowerPoint 2003, Office Excel 2003, Office Word 2007, Office PowerPoint 2007, Office Excel 2007, Word 2010, PowerPoint 2010, Excel 2010, Word 2013, PowerPoint 2013, and Excel 2013 ignore this property unless the registry key **HKEY_CURRENT_USER\Software\Microsoft\Office\\*version*\>\Outlook\Options\Mail** has a **DWORD** value named "AdHocReviewBehavior" with a value of 0, where \<*version*\> is "11.0" for Office Word 2003, Office PowerPoint 2003, and Office Excel 2003; "12.0" for Office Word 2007, Office PowerPoint 2007, and Office Excel 2007; "14.0" for Word 2010, PowerPoint 2010, and Excel 2010; or "15.0" for Word 2013, PowerPoint 2013, and Excel 2013. [\<71\> Section 2.3.3.2.3.3](#Appendix_A_Target_71): Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, and Word 2013 create links to bookmarks for their linked properties, where the link entry’s value is the name of the bookmark. Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 create links to named ranges for their linked properties, where the link entry’s value is the name of the range. PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, and PowerPoint 2013 create links to bookmark portions of slide content for their linked properties, where the link entry’s value is the identifier of the bookmarked slide content. [\<72\> Section 2.3.6](#Appendix_A_Target_72): Word 97, Word 2000, Word 2002, Office Word 2003, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Excel 97, Excel 2000, Excel 2002, and Office Excel 2003 do not create this [**storage**](#gt_63525252-3f66-4459-9b64-5b77f57b2f84). [\<73\> Section 2.3.6.1.4](#Appendix_A_Target_73): Custom XML data item with the target namespace http://schemas.microsoft.com/office/2006/coverPageProps is only written by Office Word 2007, Word 2010, and Word 2013. [\<74\> Section 4.3](#Appendix_A_Target_74): If the digest data of the digital signature is not MD5 encoded, the signature will not be verified by existing versions of Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, Word 2013, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, PowerPoint 2013, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013. # 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 | |----|----|----| | [1.2.1](#Section_5b8f8b38b2ed4d89b91a585888ccbf5d) Normative References | Updated to a newer \[ITUX680\] reference throughout the document. | Minor | # Index A [Applicability](#section_b3b33c72826242d7acaad46e1d55985f) 23 [property set storage](#section_9f9aa29768344d14831be17d7694002e) 23 [toolbar customization](#section_9f1e83998e3144f5b1f0eab03640eadc) 23 [Visual Basic for Applications digital signature](#section_1ee62b59b872477b974374470ec3fcbe) 23 Apply format exceptions [Bhutanese](#section_e8dc883bc79c4dba8cf9bd5b35964b90) 135 [Bokmal (Norwegian)](#section_b38c49f616ce4115a5d83a5aeba713b7) 132 [Czech](#section_3e6fa7b3d8c341af83d5ce35cfe6818d) 132 [Danish](#section_f8dd4ba2ecb1407991e67ce644cc80ac) 132 [Dutch](#section_cecb8c679f6f4edab1e4c7f5a43de7fe) 133 [Finnish](#section_c6ed18a249414ec59ece73713234cf27) 133 [French Canadian](#section_2f434cef271f489cb017011d577a3880) 133 [German](#section_5057be85b6344f5781d9fd859c0aaf78) 133 [Hungarian](#section_df404400602444eba084c8c8e3570009) 133 [Italian](#section_0c8c25de82dc4ba596b6f0ce56a7565b) 133 [Japanese](#section_508fa132cc0a46d99100c9599b28bf83) 133 [Kazakh](#section_523ebb796f384127ac43a1ec9ddabb0a) 133 [Khmer](#section_f530a560001a4bcd8bf335ec0ef07353) 134 [Korean](#section_3386fc600ca843be808c809386d40fc1) 134 [Lao](#section_49386e4e393641bb9e6494d30d3d0f99) 134 [Lithuanian](#section_d29d131e76514a4b997b811a029cb6f6) 134 [Polish](#section_e4e74b58661b41bdb47a0a05c564ef60) 134 [Portuguese](#section_fade7d578ff04a2094fb6bb97b40d9e6) 134 [Russian](#section_3d87821b2b514fe8ac0c74f1792e587a) 134 [Spanish](#section_48f983f3e9284d95b194090e4e103981) 134 [Swedish](#section_634c533fe82a40ca9c1516b067df6064) 134 [Tibetan](#section_a349cd4025df4f4883bb95ec7527797f) 135 [Uzbek Cyrillic](#section_827120fff2b244629dc6f8659a383a8c) 135 [Vietnamese](#section_0393b3a48fc9418b97bf26d2bc41f68d) 135 C [Change tracking](#section_7ddc5e929a1e4ca9938181e0f0ac67b2) 195 [Common ABNF definitions](#section_5ea38ff9bfa242eb998830ff844edbc8) 25 Common algorithms [date/time format from format index](#section_8b810eea93e24577bc840d4f05e41faf) 126 [hyperlink hash](#the-result-of-the-algorithm-is-the-value-dwhash.hyperlink-hash) 125 [MsoCrc32Compute](#section_324014d139aa4038bbf4f3781732f767) 125 [Unicode string to unsigned integer hash](#section_fe607d6aedef4a9191a184f537a03554) 124 Common data types DataViewAspectEnum ([section 2.2.1.1](#Section_2c82dd3e362a42b2a56b44f09fb3cd8f) 27, [section 2.2.1.2](#Section_a503927129944e5795187d5ae9836f0b) 27) [FilePointer](#section_0566aac8327c404186e5e4142458d93e) 30 [FixedPoint](#section_eaf84504e46e44b087197bd8eff6d35b) 30 [MSONFC](#Section_57c8f7d4142644e0b58d6fa1a5a81659) 27 [WebScreenSizeEnum](#Section_d033a231279a42daa71c260412bdd451) 29 Common objects [document signature serialized certificate store structure](#section_3b94f5604aa24c89bd0f55e293c3fbc7) 124 [hyperlinks](#section_8826206b935b4daaaa292ee4134ef202) 104 [MsoEnvelope](#section_f7c1375ecff349c6b62f39492273827c) 113 [toolbar customization](#section_a38b2b42f81045358ffb175863574222) 30 Cover page properties [Abstract](#section_df05d7588d6647b4bbff5a7f11ae446c) 101 [CompanyAddress](#section_c09e991e764a40748c201214c6634a48) 101 [CompanyEmail](#section_e212a2749e464501afa1d4cf1f7f1256) 101 [CompanyFax](#section_eb00ac2c2e4447f9a150dee3880a2947) 101 [CompanyPhone](#section_5a6b2056449a4ad4935ee114c8cf1218) 101 [CoverPageProperties](#section_252c6032cf674f6c91d65f56ea66c7da) 102 [PublishDate](#section_9dccbce275e24276a0bbf066c67dbbae) 101 [ST_PublishDate](#section_0bc1d3233ce34b599dd4143bf9a1a7a9) 101 Custom property editor [customPropertyEditor](#section_2169d00b14074f15abcab1ee8aa2a2a1) 90 [customPropertyEditors](#section_67e2ad00a4b74887a5b5f96ec69765a9) 90 [defaultPropertyEditorNamespace](#section_b820dac0f2cf405f9da3912331ed527f) 90 [XMLNamespace](#section_4eff429624e14042a785bc135c4d63df) 89 [XSNLocator](#section_47b70b8b19764430ade6b3f6adf2262f) 89 [Custom XML data storage](#section_e4521fcce23542979351d268ebb7a9d7) 88 [custom XML data storage properties](#section_8d4c97e66af4473aa6acef7ce89ccbf2) 103 [showOnOpen](#section_b529581ef7d94e4086694155b82ca0d5) 89 [Custom XML data storage item](#section_4bd09eb4a447471ebb34b6be107ab54d) 88 [cover page properties](#section_1deeffdeda944ce78188af1ef5d29e67) 101 [custom property editor](#section_85d6920daf9f49d9873bbab3e41ae0ff) 89 [custom Xsn](#section_cadcb03133274023952d6607c1ab634e) 91 [Long properties](#section_6ad9a50924ce46ffb28f77bcd3139b32) 102 Custom XML data storage properties [dataStoreItem](#section_a8fb433020724dd8962bfc57e7dfc5dd) 104 [schemaRef](#section_9cb777251f9c465bb7e880ef27929002) 103 [schemaRefs](#section_40b3b0b5243e4f6f8e645f446fb70ac2) 103 [ST_Guid](#section_2f3a48cb3142403c962afa02061b7d9b) 103 Custom Xsn [cached](#section_47752cf7ea8b4994a685259f261254e7) 91 [customXsn](#section_ceb529d2572a46a7a8d33951e059de4f) 92 [openByDefault](#section_4feeb65bf49248b2bc25bd0155c9bf1f) 91 [ST_TrueFalse](#section_eb5c4d8a0cb745c5b46700c35243cc5a) 91 [xsnLocation](#section_6a40521d8a294cc9b8590078594cd322) 91 [xsnScope](#section_b7a74aaeac8e4670987baac055ce7125) 92 D Date/time format from format index [apply format exceptions](#section_e060e93ec7a948b58994b41e6bfef893) 132 [base format strings](#section_7c195e8c262d42ef9c7d2bf9a8880c3e) 127 [format indices](#section_155503da75d84f02a1a4b13e7bba430b) 126 [retrieve format](#section_991de52a78bd474ebaa658a675501996) 127 Document signature serialized certificate store structure [DocSigSerializedCertStore](#Section_37d4b77da7d340fe9c3bcd327444f6ff) 124 Document summary information examples [Category property](#section_29d75dd8a0654c23948c8f705f01f986) 151 [CodePage property](#section_ee2488688fde440db81bbc27d1c7811d) 150 [document summary information property set overview](#section_c0e0190a08284638ab746fc190da3582) 147 [document summary information stream overview](#section_2ea8be67a4a04e2eb42f49a182645562) 145 [DocumentParts property](#section_742bc556d7884900b7aeb8fe1f2e4322) 152 [HeadingPairs property](#section_887bb6a81f9c4d4abf3dcf6062e4c6a4) 155 [Hyperlinks property](#section_fbfec8b87db44a60bc0e5ea0b1bc2328) 163 [LineCount property](#section_c93a7a10a41945639a2ed4b4dc51cf94) 151 [LinkElement - 1](#section_37a17baf223446bc95d4cd0ad42735f6) 164 [LinkElement - 2](#section_e49f3f560ff446e89e2b113cdc0df22e) 166 [LinkElement - 3](#section_fcb66d121ea0407bae648ac68881703e) 168 [LinkElement - 4](#section_c0c7621ea29d4f5583baaabdbca3d932) 169 [LinkElement - 5](#section_542e43e1ae964e63be5e9012ec4d1128) 171 [LinkElement - 6](#section_caafc24928e04955af22541a9084e45c) 173 [LinksDirty property](#section_073efdcc7d75400396a9c48f4a3ce77c) 152 [Document Summary Information Examples example](#section_56b90d28302b40f6ba611b024fcdf29c) 143 Document summary information property set [PIDDSI](#Section_3ef02e83afef4b6c9585c109edd24e07) 75 Document summary information property set overview [Category property](#section_29d75dd8a0654c23948c8f705f01f986) 151 [CodePage property](#section_ee2488688fde440db81bbc27d1c7811d) 150 [DocumentParts property](#section_742bc556d7884900b7aeb8fe1f2e4322) 152 [HeadingPairs property](#section_887bb6a81f9c4d4abf3dcf6062e4c6a4) 155 [LineCount property](#section_c93a7a10a41945639a2ed4b4dc51cf94) 151 [LinksDirty property](#section_073efdcc7d75400396a9c48f4a3ce77c) 152 E Examples [Category property](#section_29d75dd8a0654c23948c8f705f01f986) 151 [CodePage property](#section_ee2488688fde440db81bbc27d1c7811d) 150 [document summary information](#section_56b90d28302b40f6ba611b024fcdf29c) 143 [Document Summary Information Examples](#section_56b90d28302b40f6ba611b024fcdf29c) 143 [document summary information property set overview](#section_c0e0190a08284638ab746fc190da3582) 147 [document summary information stream overview](#section_2ea8be67a4a04e2eb42f49a182645562) 145 [DocumentParts property](#section_742bc556d7884900b7aeb8fe1f2e4322) 152 [HeadingPairs property](#section_887bb6a81f9c4d4abf3dcf6062e4c6a4) 155 [Hyperlinks property](#section_fbfec8b87db44a60bc0e5ea0b1bc2328) 163 [LineCount property](#section_c93a7a10a41945639a2ed4b4dc51cf94) 151 [LinkElement - 1](#section_37a17baf223446bc95d4cd0ad42735f6) 164 [LinkElement - 2](#section_e49f3f560ff446e89e2b113cdc0df22e) 166 [LinkElement - 3](#section_fcb66d121ea0407bae648ac68881703e) 168 [LinkElement - 4](#section_c0c7621ea29d4f5583baaabdbca3d932) 169 [LinkElement - 5](#section_542e43e1ae964e63be5e9012ec4d1128) 171 [LinkElement - 6](#section_caafc24928e04955af22541a9084e45c) 173 [LinksDirty property](#section_073efdcc7d75400396a9c48f4a3ce77c) 152 [SmartTag](#section_1e45e265a6c0418f9b902d1fc53ad7ae) 175 [SmartTag Examples](#section_1e45e265a6c0418f9b902d1fc53ad7ae) 175 [toolbar control](#section_1a66784c61e64ee58e499d39be874354) 136 [toolbar customization](#section_9bece780e23c4b249fbf34b879863a34) 136 [Toolbar Customization Examples](#section_9bece780e23c4b249fbf34b879863a34) 136 [toolbar delta](#section_8209042370e744b29ea0c69f55208358) 141 [user defined property set overview](#section_283eeaa13610403da42032c8a16945e0) 157 [Visual Basic for Applications Digital Signature Example Structures](#section_715a782baacd4743acadab3c55d694ee) 181 [Visual Basic for Applications digital signature storage structure](#section_715a782baacd4743acadab3c55d694ee) 181 F [Fields - vendor-extensible](#structure-versions-there-is-only-one-version-of-the-vba-digital-signature-defined-in-visual-basic-for-applications-digital-signature-storage-section-2.3.2.localization-the-vba-digital-signature-structures-define-no-locale-specific-processes-or-data.vendor-extensible-fields) 24 G [Glossary](#glossary) 9 H Hyperlinks [AntiMoniker](#Section_e56f55e7320d45beb5463250dd314f82) 107 [CompositeMoniker](#Section_b5e2deb030694bacbc749433311f691b) 107 [FileMoniker](#Section_c28c62d7adc5405585dbd957069965ac) 111 [Hyperlink object](#Section_c04372224868466081f86b7ee236d3f8) 104 [HyperlinkMoniker](#Section_0cc5cf392a1645a9a7fb8994ce3f01a5) 106 [HyperlinkString](#Section_1a9f6231df634a95b9985c2b95b82965) 112 [ItemMoniker](#Section_fae1319fa20942b4b60fb2bb25cdc22c) 107 [URICreateFlags](#Section_1786df8eb7924a28b7c54d9a91d2e401) 109 [URLMoniker](#Section_4948a119c4e446b696090525118552e8) 109 Hyperlinks property example [LinkElement - 1](#section_37a17baf223446bc95d4cd0ad42735f6) 164 [LinkElement - 2](#section_e49f3f560ff446e89e2b113cdc0df22e) 166 [LinkElement - 3](#section_fcb66d121ea0407bae648ac68881703e) 168 [LinkElement - 4](#section_c0c7621ea29d4f5583baaabdbca3d932) 169 [LinkElement - 5](#section_542e43e1ae964e63be5e9012ec4d1128) 171 [LinkElement - 6](#section_caafc24928e04955af22541a9084e45c) 173 I [Informative references](#informative-references) 17 [Introduction](#introduction) 9 L Long properties [LongProp](#section_8ed57b888c0841dba4a93471853de759) 102 [LongProperties](#section_3e0d6857c12443a6a14493ee50a79e44) 102 M MsoCrc32Compute [caching algorithm](#section_4186e6d756d6456992e814a9c93f2af1) 125 [CRC computation](#section_ba71f3bafa454b65bb36ac3b465d6761) 126 MsoEnvelope [EnvAttachment](#Section_a8ff6fd332d14fd0ad6a5f3a0cf3bcce) 122 [EnvAttachmentCollection](#Section_706192e0b6734ba2a1548f4dfc9f0165) 122 [EnvRecipientCollection](#Section_5deabdf8d4604a4ca0a64cb7cefaf75d) 117 [EnvRecipientProperties](#Section_f9e2a31453104779b5a8ecf6817703bd) 117 [EnvRecipientProperty](#Section_8df36d0a49eb4f41910bcec9ba5120e8) 118 [EnvRecipientPropertyBlob](#Section_2ce2498ef44f4ceaaf7059c3abc4c129) 118 [IntroText](#Section_01e96fcbe7504b1f94249d05b8545403) 123 [MsoEnvelope](#Section_52f153930e4f4bd9a521dcb8f0a869ef) 113 [MsoEnvelopeCLSID](#Section_d1be9a70298942a0a6e873473fe98911) 113 [PT_BINARY](#Section_5eb7ad4f284c427ea7f6b2b418a0b403) 121 [PT_BOOLEAN](#Section_bfed9f7b80e24683b8aae31c269edc37) 119 [PT_ERROR](#Section_b26e9a2c53c047e89961999b63be162a) 120 [PT_LONG](#Section_14c87459b96747838c07c577771d4692) 119 [PT_MV_BINARY](#Section_21b12ab606c44eaabf302224ccac74f1) 122 [PT_MV_STRING8](#Section_19c08692116741bf9801053c11225c69) 121 [PT_NULL](#Section_baff4515df094c9f85ecc5c1b2750111) 119 [PT_STRING8](#Section_0c75d01a68c844bf9b4480a73d052db5) 120 [PT_SYSTIME](#Section_b9f7856615ae419fafa944265c9f4092) 120 [PT_UNICODE](#Section_274cc379b1964a8f89baeb9cf0baf7fc) 120 N [Normative references](#normative-references) 15 O [OLE property sets](#section_0105a8ee6e664b1281a5d3d39c8270f2) 72 [document summary information property set](#section_fe59ffd979e944fba1c92466057b05c6) 74 [summary information property set](#section_11b5612735f44bfaa23f23935a6edf54) 72 [Overview (synopsis)](#structure-overview-synopsis) 17 P [Product behavior](#section_76e644d885d243f3bbc8c649f080e101) 186 [Property set storage](#section_9673a168c71544eb882502cfa2b4627d) 61 [Property types](#section_0bc7362e62d4496995ff4c19edb1b104) 61 [Lpstr](#Section_fac324c9ff39442ebd181a91a723a818) 63 [Lpwstr](#Section_e5f5c0973b4440f293ccab4ce521f82d) 64 [PropertySetSystemIdentifier](#Section_6ac486b48d634cdebd729c2306a482fe) 61 [UnalignedLpstr](#Section_a8f75582c3d34a5bbbca62ed6a05711d) 64 [VecVtHyperlink](#Section_754880cc03d448e794fcd9f6573f11af) 71 [VtDigSig](#Section_e1f6b35d7e064dbc880ba074fabcd06d) 69 [VtDigSigValue](#Section_a7c3987feaa64f8cbc5cf0dd124eb32f) 69 [VtHeadingPair](#Section_8d8db7dc9a0c4bcc9ad5a2937bb559b0) 67 [VtHyperlink](#Section_2225d544e06344ff9f70739f1c14d592) 69 [VtHyperlinks](#Section_4df4d1a8bb4746bdacd7944e817338e7) 71 [VtHyperlinkValue](#Section_f65d95215c8d4888a23ecc1b9f9d7da5) 71 [VtString](#Section_60485cf2d8d94a7f99b1d1cf275ae83c) 66 [VtThumbnail](#Section_4af3a094890c4ecc832cf212bfebbfa9) 63 [VtThumbnailValue](#Section_427efceff31c4d9e9e4ed28ff9bb6e0b) 62 [VtUnalignedString](#Section_eb04ce67f96b4ea4adf77f75847c7abb) 67 [VtVecHeadingPair](#Section_3aaaf9e84f1a42fa9359fe0ab0c1cccc) 68 [VtVecHeadingPairValue](#Section_7eaa201d3fe149178e393690a3a36c11) 68 [VtVecLpwstr](#Section_2dc59d31a90349bba1f145fc01c8b8b0) 65 [VtVecLpwstrValue](#Section_112762c273624710afad1f4c8bc6a814) 65 [VtVecUnalignedLpstr](#Section_523af67dd69a4eb1848ba299674ac9b8) 66 [VtVecUnalignedLpstrValue](#Section_cd95ca9770c748288b5bb86263348026) 65 R [RefEdit control](#section_45556c0e0f424c79864e503cd04e38ba) 88 [References](#references) 15 [informative](#informative-references) 17 [normative](#normative-references) 15 Relationship to protocols and other structures [property set storage](#ms-ctdoc-for-the-persistence-format-for-word-processing-documents.ms-ctxls-for-the-persistence-format-for-spreadsheet-toolbar-customization-structures-defined-in-this-document.-property-set-storage) 23 [toolbar customization](#section_884451bdb7a5486c93632b984d92226e) 22 [Visual Basic for Applications Digital Signature](#section_1281abccebd9419f8c0be995c5789d7d) 23 Retrieve format [Chinese formats](#section_fc1c7b8a34fa4e669449fb8e5719d368) 127 [formats for all other locales](#section_06344de126ec4490a4d73d6311fc0bb5) 131 [Hindi formats](#section_58059fc1f2494a10bab4faf361360e88) 128 [Japanese formats](#section_0f59a13d46d04835bec88c430ba26f54) 128 [Korean formats](#section_d3008e516ff043798b441a9569c4dbba) 129 [Taiwanese formats](#section_28531aa4ed214946a5e64d2cff6f843f) 129 [Thai formats](#section_6fa4db1946f841afa974beb3f4aa053e) 130 [Yi formats](#section_db987d364d92407aa9699aa4173d8692) 130 S [Schema for content type](#section_5a76628af8624994a57eec37de5c6c78) 92 [ContentTypeId](#section_e03d125c11a44decae95996d808aa344) 92 [contentTypeSchema](#section_708783bb2f0e4fa490372a952688f757) 98 [DummyContentTypeElement](#section_e1f362d7a9e543b387fafa73531ad4e2) 93 [IntNonNegative](#section_7100e5ee24f74cec89d01e03ed3129ee) 93 [schema](#section_a19e7eeb1ab54d64bcc9dff9a6399ba4) 98 [UniqueIdentifierWithoutBraces](#section_7632be5c7d4844a5959ea5b4bdcc8ffc) 93 [UniqueIdentifierWithoutBracesOrEmpty](#section_50ffad9914214f9e9e601b1bf1fedf28) 93 Security [property set storage](#section_a55c16e74ec94e1f91e157c007ab04b3) 185 [toolbar customization](#section_a50bb0b780f849a8b1f03c0b3dde3cfa) 185 [visual basic for applications digital signature](#section_40c8dab3e8db4c66a6be8cec06351b1e) 185 Security considerations [property set storage](#section_a55c16e74ec94e1f91e157c007ab04b3) 185 [toolbar customization](#section_a50bb0b780f849a8b1f03c0b3dde3cfa) 185 [Visual Basic for Applications digital signature](#section_40c8dab3e8db4c66a6be8cec06351b1e) 185 [Serialized certificate store structure](#the-certificate-chain-for-the-countersignature-must-be-built-according-to-a-trusted-root-certificate-by-using-x.509-path-validation-rules-as-specified-by-rfc3280-section-6.the-time-stamp-authority-tsa-certificate-that-was-used-to-sign-the-timestamp-must-contain-the-eku-value-for-timestamping-1.3.6.1.5.5.7.3.8.serialized-certificate-store-structure) 58 [CertStoreCertificateGroup](#Section_462654f19be347f59c1ea6d328ac52e0) 60 [EndElementMarkerEntry](#Section_020eb66c88e3466b80f60e3ce84d0544) 59 [SerializedCertificateEntry](#Section_38a1970aa95e49a4bcaf6d8c10ddd5ac) 58 [SerializedPropertyEntry](#Section_b8e9c71efe594c568419a2ed2a5858f0) 59 [VBASigSerializedCertStore](#Section_e88d644c80f84016a2c093fc5b110877) 60 SignedData contentInfo structures [SpcIndirectDataContent](#section_1537695a28f048288b7bd6dab62b8030) 54 [SpcIndirectDataContentV2](#the-digestalgorithm-field-must-be-an-algorithmidentifier-structure.-the-algorithm-field-of-digestalgorithm-specifies-the-object-identifier-itux680-of-the-digest-algorithm-that-was-used-to-hash-the-vba-project-contents-producing-the-value-for-the-digest-field.-this-object-identifier-itux680-value-must-be-set-to-the-same-algorithm-identifier-as-specified-in-the-digestalgorithm-field-of-the-signeddata-structure-section-2.3.2.4.1.-the-parameters-field-of-digestalgorithm-must-be-set-to-the-null-type-itux680-with-a-length-of-zero.the-digest-field-must-be-an-octetstring-itux680.-the-value-of-the-octetstring-must-be-produced-by-means-of-the-hash-algorithm-specified-in-ms-ovba-section-2.4.2.spcindirectdatacontentv2) 55 SignerInfo authenticatedAttributes structures [SpcLink](#section_7cb90c30902f48d7a5ee686ce1ff0d36) 57 [SpcSpOpusInfo](#section_917556324b0d44ca89a99699afbbd268) 57 [SpcStatementType](#section_c541e3e43d044cbd82db1b73163427fd) 57 [SpcString](#section_d5bcc38d051f47758c4474d52e301702) 57 [SignerInfo unauthenticatedAttributes](#section_2dca257e8a014526adc2bbc62861f05b) 57 [SmartTag Examples example](#section_1e45e265a6c0418f9b902d1fc53ad7ae) 175 [SmartTag objects](#section_55082f95b0e94cdc98dde89bc184c1b0) 85 [FactoidType](#Section_e20c3d1400c8439b87a07cd8bc7dfdd9) 86 [PBString](#Section_0f70d2f799e9485398feedfc98825792) 88 [Property](#Section_61d78938ed384cb39c6b9f42fdd24894) 87 [PropertyBag](#Section_5dbba3b5db16449ebb6286967fa7d21b) 87 [PropertyBagStore](#Section_e9e83dea3953448f8cdd2392b6ba76a3) 85 Structure overview (synopsis) [byte ordering](#section_d6caa7df142c4991b863541235e23a07) 22 [property set storage](#section_8419d374b2ec49fbb73650dd19108910) 19 [RefEdit control](#section_85f8bdd6a41b4b28b2c365ab1e335853) 20 [toolbar customization](#toolbar-customization) 17 [Visual Basic for Applications digital signature](#section_210c866a8b2f40ad8db8874130e1383a) 20 Summary information property set [PIDSI](#Section_87667163ea1e4d679eec47cad74e8030) 72 T Toolbar customization ([section 1.3.1](#toolbar-customization) 17, [section 1.4.1](#section_884451bdb7a5486c93632b984d92226e) 22, [section 1.5.1](#section_9f1e83998e3144f5b1f0eab03640eadc) 23, [section 1.6.1](#section_d85df01755284489a94f8fd5cf42369a) 23, [section 1.7.1](#section_efed041370ae47b48db2bf9f1e0e3ca1) 24, [section 2.3.1](#section_a38b2b42f81045358ffb175863574222) 30) [BITMAPINFOHEADER](#Section_5eb5fc23797e4e428ef1ef844994d7d4) 31 [RGBQuad](#Section_635c7c9d5a7f45dc98c1577be7d0f7ac) 32 [SRECT](#Section_21c05acf851f4874bdcbd69e94bffed1) 33 [TB](#Section_4b59413771ec456fbaf9ba1dd0a28c5c) 34 [TBCBitmap](#Section_24c6da6cfc9f4815ad189a7a3a6d9205) 30 [TBCBSFlags](#Section_d6b3333d6f7042848b41752d3ede4116) 47 [TBCBSpecific](#Section_6f6f5f9fe2f04f0d9d6fb15395b364c0) 46 [TBCCDData](#Section_aa9aecdd1d154724adecc1f6bd7e8c59) 49 [TBCComboDropdownSpecific](#Section_d264bd1960084eb5ba7ce1e12a80c7a3) 48 [TBCData](#Section_2abc9423fd1b49c490986846ddc07283) 43 [TBCExtraInfo](#Section_feebb647ba9c40378718babc740201c5) 45 [TBCFlags](#Section_8b35e28b45f14e92ab1a39fa84e0fb2b) 40 [TBCGeneralInfo](#Section_99109267262941139ceca9481d6d606d) 44 [TBCGIFlags](#Section_5a7caae568844e45b93687022aa2f2d6) 44 [TBCHeader](#Section_6fec0363d40148aaacdf46b7a8bf31db) 39 [TBCMenuSpecific](#Section_912bf645a367471b9d4efc29583a01bc) 49 [TBCSFlags](#Section_df3f6f9b34c6451fad13765c2cb63c09) 40 [TBFlags](#Section_2809bc150e0d4c959444e624aa9b76ec) 36 [TBTRFlags](#Section_e51860d90eb74d6b8608a6eaf078dd53) 34 [TBVisualData](#Section_1b41ab5402664559bc7b92a02483362b) 36 [WString](#Section_9aa198843ab34da3a4aff2db446befda) 33 Toolbar customization examples [toolbar control](#section_1a66784c61e64ee58e499d39be874354) 136 [toolbar delta](#section_8209042370e744b29ea0c69f55208358) 141 [Toolbar Customization Examples example](#section_9bece780e23c4b249fbf34b879863a34) 136 [Tracking changes](#section_7ddc5e929a1e4ca9938181e0f0ac67b2) 195 U [User defined property set](#section_54514afbff194348be71395854d4432d) 78 [linked properties](#section_97ac7ca64fab4fb582527bb52a36fde2) 85 [reserved properties](#vtstring-section-2.3.3.1.11typedpropertyvalue-ms-oleps-section-2.15-the-type-of-which-must-be-one-of-the-following-typesvt_i4-0x0003vt_r8-0x0005vt_bool-0x000bvt_filetime-0x0040vt_blob-0x0041reserved-properties) 79 [User defined property set constraints](#section_1edd5ada132a4108af3323225e159aa8) 79 [required properties](#section_1414f765ea8e4a1ea19c641500e5f93d) 79 [supported types](#section_f49b1757718e4292a42f4164ce9abdf1) 79 User defined property set examples [user defined property set overview](#section_283eeaa13610403da42032c8a16945e0) 157 User defined property set overview [Hyperlinks property](#section_fbfec8b87db44a60bc0e5ea0b1bc2328) 163 [LinkElement - 1](#section_37a17baf223446bc95d4cd0ad42735f6) 164 [LinkElement - 2](#section_e49f3f560ff446e89e2b113cdc0df22e) 166 [LinkElement - 3](#section_fcb66d121ea0407bae648ac68881703e) 168 [LinkElement - 4](#section_c0c7621ea29d4f5583baaabdbca3d932) 169 [LinkElement - 5](#section_542e43e1ae964e63be5e9012ec4d1128) 171 [LinkElement - 6](#section_caafc24928e04955af22541a9084e45c) 173 V [VBA Digital Signature](#section_7c4ce2e22a714b028f51b9f0eeed756a) 53 [SignedData constraints](#section_708462617bc14c3094fe29ebf7f697ff) 53 [SignedData contentInfo structures](#the-authenticatedattributes-section-2.3.2.4.4-field-must-be-present.this-field-must-contain-the-following-attributesa-content-type-attribute-with-its-value-set-as-specified-in-pkcs7-section-9.2.a-message-digest-attribute-with-its-value-set-as-specified-in-pkcs7-section-9.2.this-field-can-also-containone-spcstatementtype-attribute-section-2.3.2.4.4.1-but-this-attribute-must-be-ignored.one-spcspopusinfo-attribute-section-2.3.2.4.4.2.if-the-signature-has-been-timestamped-then-the-unauthenticatedattributes-field-section-2.3.2.4.5-must-be-present-and-must-contain-a-single-countersignature-attribute-pkcs9-section-6.6.-if-the-signature-has-not-been-timestamped-the-unauthenticatedattributes-field-must-be-absent.signeddata-contentinfo-structures) 54 [SignerInfo authenticatedAttributes structures](#the-algorithmidsize-field-must-be-an-integer-itux680-and-the-value-must-be-equal-to-the-size-of-the-algorithmid-field.the-compiledhashsize-field-should-be-zero.the-sourcehashsize-field-must-be-an-integer-itux680-and-the-value-must-be-equal-to-the-size-of-the-sourcehash-field.the-algorithmidoffset-field-must-be-an-integer-itux680-and-the-value-must-be-equal-to-the-position-in-bytes-of-the-algorithmid-field-from-the-beginning-of-the-structure.the-compiledhashoffset-field-should-be-zero.the-sourcehashoffset-field-must-be-an-integer-itux680-and-the-value-must-be-equal-to-the-position-in-bytes-of-the-sourcehash-field-from-the-beginning-of-the-structure.the-algorithmid-field-specifies-the-object-identifier-itux680-of-the-digest-algorithm-that-was-used-to-hash-the-vba-project-contents-producing-the-value-for-the-digest-field.-this-object-identifier-itux680-value-must-be-set-to-the-same-algorithm-identifier-as-specified-in-the-digestalgorithm-field-of-the-signeddata-structure.the-compiledhash-field-should-be-empty.the-sourcehash-field-must-be-an-octetstring-itux680.-the-value-of-the-octetstring-must-be-produced-by-means-of-the-hash-algorithm-specified-in-ms-ovba-section-2.4.2.signerinfo-authenticatedattributes-structures) 56 [SignerInfo constraints](#the-digestalgorithms-field-must-contain-only-one-digestalgorithmidentifier-pkcs7-section-6.3-and-that-digestalgorithmidentifier-must-specify-the-identifier-of-the-algorithm-used-to-create-the-digest-of-the-signature.10the-contentinfo-fields-contenttype-must-be-an-object-identifier-itux680-with-the-value-1.3.6.1.4.1.311.2.1.4.-the-content-field-of-the-contentinfo-of-this-signeddata-structure-must-be-a-spcindirectdatacontent-structure-section-2.3.2.4.3.1.the-certificates-field-must-contain-certificates-as-specified-by-pkcs7-section-9.1.-this-must-include-the-signature-verification-certificate-and-can-contain-any-intermediate-certificates-between-that-end-entity-and-the-root-including-the-root.-if-the-signeddata-contains-a-countersignature-pkcs9-section-6.6-the-certificates-associated-with-the-countersignature-also-must-be-contained-in-the-certificates-field.the-crls-field-should-be-absent.-if-present-the-crls-field-must-be-ignored.the-signerinfos-field-must-contain-a-single-signerinfo-structure-section-2.3.2.4.2-pkcs7-section-9.2.signerinfo-constraints) 53 [VBA digital signature verification](#section_fb2ddf4fc927478bb27ecf4d3bff2898) 58 [certificate processing](#section_d4a5396376c54e8c9c7e459e8426cec7) 58 [Timestamp processing](#section_ad34050a39bb4482b973db85586bccd8) 58 [Vendor-extensible fields](#structure-versions-there-is-only-one-version-of-the-vba-digital-signature-defined-in-visual-basic-for-applications-digital-signature-storage-section-2.3.2.localization-the-vba-digital-signature-structures-define-no-locale-specific-processes-or-data.vendor-extensible-fields) 24 [property set storage](#section_711cba7a97a14411bf707040ee98e9e1) 24 [toolbar customization](#section_efed041370ae47b48db2bf9f1e0e3ca1) 24 [Visual Basic for Applications digital signature](#section_1b44a4f1c92a4ad6ba6dfca5bce54c96) 24 Versioning and localization [property set storage](#structure-versions-there-is-only-one-version-of-the-toolbar-customization-structures-section-2.3.1.localization-the-toolbar-customization-structures-define-no-locale-specific-processes-or-data.property-set-storage) 24 [toolbar customization](#section_d85df01755284489a94f8fd5cf42369a) 23 [Visual Basic for Applications digital signature](#structure-versions-there-is-only-one-version-of-the-property-sets-defined-in-property-set-storage-section-2.3.3.localization-the-encoding-of-strings-contained-in-the-lpstr-section-2.3.3.1.4-data-type-and-the-unalignedlpstr-section-2.3.3.1.5-data-type-depend-on-the-property-sets-codepage-property-described-in-ms-oleps-section-2.18.2.visual-basic-for-applications-digital-signature) 24 [Visual Basic for Applications Digital Signature Example Structures example](#section_715a782baacd4743acadab3c55d694ee) 181 [Visual Basic for Applications digital signature storage](#section_f80ee18cd72f4c3c9ea5a56f396322e0) 50 [DigSigBlob](#Section_bc21c922b7ae473690aa86afb6403462) 52 [DigSigInfoSerialized](#Section_30a00273dbee422fb488f4b8430ae046) 50 [WordSigBlob](#Section_0a2166b32e294b12886dd89f23c6824c) 52