DOC: Instructions for Statically Linking to Registrar Code

Last reviewed: June 25, 1997
Article ID: Q166717
The information in this article applies to:
  • Microsoft Active Template Library, versions 2.0, 2.1

SUMMARY

The Microsoft Active Template Library (ATL) Help article entitled "Setting Up a Static Link to the Registrar Code" says the following:

    <<<<<<<<<<
    At the top of stdafx.h, add the following #define statement:
    #define _ATL_STATIC_REGISTRY
    >>>>>>>>>>

This causes a series of compiler errors and warnings when you build for "Win32 Release MinSize":

   <<<<<<<<<<
   C:\Program Files\DevStudio\VC\ATL\include\atlimpl.cpp(1010) : error
    C2259:
   'CRegObject' : cannot instantiate abstract class due to following
   members:
   C:\Program Files\DevStudio\VC\ATL\include\atlimpl.cpp(1010) : warning
   C4259: 'long __stdcall IUnknown::QueryInterface(const struct _GUID
    &,void
   ** )' : pure virtual function was not defined
   ...
   >>>>>>>>>>

Go into Project/Settings and click on the C++ tab. Under "Preprocessor definitions," replace _ATL_DLL with _ATL_STATIC_REGISTRY.

If the project was built using the "ATL COM AppWizard," you can also just pick "Win32 Release MinDependency," which already has the correct preprocessor definitions set for statically linking to the Registrar code.

MORE INFORMATION

ATL 2.x accesses the system registry through the ATL Registry Component (Registrar). You can dynamically link to the Registrar but you will have to distribute Atl.dll with your application. If you don't want to distribute Atl.dll, you can statically link to the Registrar but this increases the size of your executable by approximately 5K. The ATL library allows you to set this option via preprocessor definitions. _ATL_DLL means you want to dynamically link with the Registrar. _ATL_STATIC_REGISTRY means you want to statically link with the registrar.


Keywords : AtlReg kberrmsg
Technology : kbAtl kbInetDev
Version : 2.0 2.1
Platform : WINDOWS
Issue type : kbdocerr


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: June 25, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.