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 following file is available for download from the Microsoft Download Center:
For additional information about how to download Microsoft Support files, click the following article number to view the article in the Microsoft Knowledge Base:
THE TEXT OF GC1039
Microsoft(R) MS-DOS(R), Windows(R), Windows NT(R), (R) Windows 95, OS/2,
and Apple Macintosh Applications
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
- 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
- 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
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
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
This EULA is governed by the laws of the State of Washington, U.S.A.
Article ID: 111716 - Last Review: Aug 5, 2004 - Revision: 1