INF: Win32 SDK 3.5 LINK32.EXE Calls CVTRES.EXE
PSS ID Number: Q115234
Article last modified on 06-08-1994

3.50

WINDOWS NT


----------------------------------------------------------------------
The information in this article applies to:

 - Microsoft Win32 Software Development Kit (SDK) for Windows NT,
   version 3.5
----------------------------------------------------------------------

SUMMARY
=======

When you are building an application with the Win32 SDK, you can use the
CVTRES utility to add a COFF wrapper to files produced by the resource
compiler (RC) so that the files can be accepted by the linker. In the Win32
SDK, version 3.1, the sample makefiles were set up so that RC produced a
.RES file, which CVTRES converted into an .RBJ file. The .RBJ file was then
linked into the executable file.

With the tools that are included in the Win32 SDK, version 3.5, it is no
longer necessary to call the CVTRES utility directly to convert .RES files
to .RBJ files. The linker (LINK) calls CVTRES directly when it detects an
unconverted .RES file.

The linker included in VC++ 1.0 for Windows NT converts the .RES files
internally, without calling the CVTRES utility, so that CVTRES is not
shipped with this product. Therefore, if you copy the Win32 SDK 3.5 linker
to your \MSVCNT\BIN directory in order to use it with the VC++ 1.0 for
Windows NT tools, make sure that the linker can locate the CVTRES utility
as well. That is, it needs to be copied to the \MSVCNT\BIN directory or it
needs to be made available through the PATH environment variable. If the
linker cannot find the CVTRES.EXE file, the following error is generated:

   LNK1123: failure during conversion to COFF : file invalid or corrupt

MORE INFORMATION
================

All of the Win32 SDK sample makefiles were updated for version 3.5, so that
they no longer include lines that begin $(cvtres) or CVTRES.EXE. The
dependencies between .RES files and .RBJ files were also removed from the
makefiles. The .RES files are now linked to the executable files directly.

Additional reference words: 3.5
KBCategory: Tls
KBSubcategory: TlsMisc

=============================================================================

Copyright Microsoft Corporation 1994.
