Microsoft(R) MS-DOS(R), Windows(R), Windows NT(R), (R) Windows 95, OS/2, and Apple Macintosh Applications Versions: 3.0 Subject: Software Development Kit (SDK) for Application Note External Text File Converters Contents: 2 Pages, 1 Disk 4/97 GC1039 The files included with this Application Note comprise the software development kit (SDK) for 16-bit and 32-bit external text file converters. This SDK provides the technical information you need in order to develop external file converters that can import and export formatted text between Microsoft Word for Windows and foreign binary files. Important: Microsoft does not offer this kit as part of our product line. Microsoft will not provide technical or any other type of support for this kit. The kit contains the following components: - Microsoft License Agreement (Sdklics.doc) IMPORTANT-- READ CAREFULLY BEFORE USING SOFTWARE PACKET(S). By using the software in this kit, you indicate your acceptance of the Microsoft License Agreement included with it. - Rich Text Format (RTF) Specification (GC0165.doc) The RTF Specification document is the core material you need to write external file converters. This document describes RTF syntax, the semantics of an RTF reader, and the contents of an RTF file, including definitions of RTF keywords. - Software Development Kit for External Text File Converters and Win32(R) Software Development Kit for External Text File Converters documents (Sdk.doc and Sdk32.doc) These documents provide specifications and examples of how an external text file converter works with Word and Windows. Sdk.doc details the creation of a 16-bit converter, and Sdk32.doc details the creation of a 32-bit converter. Header files (Codepage.h, Convapi.h, Converr.h, Lang.h, Rtfdefs.h) These header files define all the structures, types, and function entry points documented in the SDK documents. Any converter or converter client should include the Convapi.h header, which itself includes Converr.h. The other files (Codepage.h, Lang.h, and Rtfdefs.h) contain definitions from the RTF specification. You can use the definitions found in these files to interpret the arguments for RTF keywords. - Sample converter sources (See the Sampcnv and Rtfread subdirectories) Refer to these sources to see an example of a simple text converter. The sample converter sources are intended for use with Microsoft C version 8.0. The Makefile file contains instructions for building the sample converter. The sample converter reads and writes simple text files, is auto-installed into Word, and contains the minimal code needed to write a fully functional converter. It implements the InitConverter, IsFormatCorrect, ForeignToRtf, RtfToForeign, and GetIniEntry application program interface (API) functions. The Rtfread directory contains source code for a skeleton RTF reader. The Readme.txt file in each directory elaborates on how to build the samples on 16-bit and 32-bit Windows. ####### The disk and software contained on it, including any accompanying documentation (the "Software"), are provided to you at no additional charge. Microsoft Corporation owns all rights, title, and interest in and to the Software. The user assumes the entire risk as to the accuracy and the use of the Software. COPYRIGHT NOTICE. Copyright (c) 1993-1997 Microsoft Corporation. Microsoft and/or its suppliers, One Microsoft Way, Redmond, Washington 98052-6399 U.S.A. All rights reserved. TRADEMARKS. Microsoft, MS, MS-DOS, Win32, Windows, and Windows NT are registered trademarks and MSN is a trademark of Microsoft Corportation. Other Microsoft products referenced herein are either trademarks or registered trademarks of Microsoft. Other product and company names mentioned herein may be the trademarks of their respective owners. The names of companies, products, people, characters and/or data mentioned herein are fictitious and are in no way intended to represent any real individual, company, product or event, unless otherwise noted. NO WARRANTY. THE SOFTWARE IS PROVIDED "AS-IS," WITHOUT WARRANTY OF ANY KIND, AND ANY USE OF THIS SOFTWARE PRODUCT IS AT YOUR OWN RISK. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, MICROSOFT AND ITS SUPPLIERS DISCLAIM ALL WARRANTIES AND CONDITIONS, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE, TITLE, AND NON- INFRINGEMENT, WITH REGARD TO THE SOFTWARE. LIMITATION OF LIABILITY. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL MICROSOFT OR ITS SUPPLIERS BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT, OR CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR ANY OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF OR INABILITY TO USE THE SOFTWARE, EVEN IF MICROSOFT HAS BEEN ADVISED OF THE POSSIBLITY OF SUCH DAMAGES. BECAUSE SOME STATES AND JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES, THE ABOVE LIMITATION MAY NOT APPLY. MICROSOFT'S ENTIRE LIABILITY AND YOUR EXCLUSIVE REMEDY UNDER THIS EULA SHALL NOT EXCEED FIVE DOLLARS (US$5.00). The following conditions also apply to your use of the Software: The Software may be copied and distributed internally only, subject to the following conditions: All text must be copied without modification and all pages must be included; If software is included, all files on the disk(s) |must be copied without modification [the MS-DOS(R)(R) utility diskcopy is appropriate for this purpose]; All components of this Software must be distributed together; and This Software may not be distributed to any third party. If you are not a Microsoft Premier customer, Microsoft shall not provide technical support for this Software. The Software is provided with RESTRICTED RIGHTS. Use, duplication, or disclosure by the Government is subject to restrictions set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraphs (c)(1) and (2) of the Commercial Computer Software-Restricted Rights at 48 CFR 52.227-19, as applicable. Manufacturer is Microsoft Corporation, One Microsoft Way, Redmond, WA 98052-6399. Any transfer of the Software must be accompanied by this statement and may only be transferred if first approved by Microsoft. You agree that you will not export or re-export the Software to any country, person, entity or end user subject to U.S.A. export restrictions, and you are responsible for complying with all applicable U.S. and local export laws in connection with the use of this Software. You warrant and represent that neither the U.S.A. Bureau of Export Administration nor any other federal agency has suspended, revoked or denied you export privileges. This EULA is governed by the laws of the State of Washington, U.S.A.