Microsoft KB Archive/307367

= How To Register COM Objects in Visual Studio .NET =

Article ID: 307367

Article Last Modified on 7/15/2004

-

APPLIES TO


 * Microsoft Visual Studio .NET 2002 Professional Edition

-



This article was previously published under Q307367



IN THIS TASK
SUMMARY
 * Steps to Register a COM Module in a Visual Studio .Net Deployment Project

REFERENCES



SUMMARY
This article explains how to successfully register a COM object in a Visual Studio .NET deployment project.

back to the top

Steps to Register a COM Module in a Visual Studio .Net Deployment Project
 Add a COM object to your Visual Studio deployment project. In the Solution Explorer, right-click the module that you just added, and then click Properties.

NOTE: The Properties window contains a table with two columns and  number of rows (the number of rows depends on the project). The left column lists the specific properties. The right column is explained in step 4. Go to Properties for this module (located by default in the upper-right corner of the .NET Deployment project), and then click Registry property.

NOTE: The Registry property specifies whether a file, assembly, or project output group should be registered on a target computer during installation. There is a list box in the right column of the Registry property, which displays several options for you to choose from. Note the following details for an explanation of these options:

 For assembly, registration is not normally required, and therefore the default is DoNotRegister (this means that the item will not be registered during the installation).

 For a COM module, you have the options of COM, COMRelativePath, and COMSelfReg. Any one of those three options will register the COM module during the installation.

Note the following details about each choice:</ul>

<ol style="list-style-type: lower-alpha;"> COM: The module will be registered as a COM object by the Windows Installer engine. The deployment project will update the Class table, ProgID table, and other tables in the Registry Tables group of the corresponding .msi file. This is the recommended way to register a COM module.</li> COMRelativePath: The module will be registered as an isolated COM object by the Windows Installer engine. Note that this module will be used only by the application that the module is installed with.</li> COMSelfReg: The installer calls the DllRegisterServer function of that module at the time that you install the module and the DllUnregisterServer function at the time that you uninstall the module. The deployment project will update the SelfReg table of the corresponding .msi file. It is not recommended that the installation package use self-registration. Instead, the installation package should register modules by authoring one or more of the other tables provided by the installer for this purpose (that is, select the COM or COMRelativePath options). Many of the benefits of having a central installer service are lost with self-registration, because self-registration routines tend to hide critical configuration information.</li></ol> </li></ol>

back to the top

<div class="references_section">