Microsoft KB Archive/305110

= HOW TO: Deploy Smart Tag DLLs by Using the Visual Studio Installer =

Article ID: 305110

Article Last Modified on 5/11/2006

-

APPLIES TO


 * Microsoft Office XP Developer Edition
 * Microsoft Visual Studio 6.0 Enterprise Edition

-



This article was previously published under Q305110





IN THIS TASK
SUMMARY
 * Deploy a Smart Tag DLL by Using the Visual Studio Installer
 * Next Steps

REFERENCES



SUMMARY
Smart tags are a feature introduced with Microsoft Office XP that allows Office developers to link text in Office XP-based documents to external resources, or to use text in Office XP-based documents in conjunction with other custom solutions. This article describes how to deploy smart tag dynamic-link library (DLL) files to Microsoft Office XP users by using the Microsoft Visual Studio Installer.

back to the top

Deploy a Smart Tag DLL by Using the Visual Studio Installer
To deploy a smart tag DLL, an Office developer could require an end user to copy the smart tag DLL to their local hard disk and manually alter their computer's registry, but this approach introduces opportunities for error and could cause maintenance headaches later.

A better approach is to use a deployment tool such as the Microsoft Visual Studio Installer. For technical information and download instructions for Visual Studio Installer, see the following Microsoft Developer Network (MSDN) Web site:

http://msdn.microsoft.com/vstudio/downloads/tools/vsi11/default.aspx

To deploy a smart tag DLL by using the Visual Studio Installer, follow these steps:  On the Start menu, point to Programs, point to Microsoft Visual Studio 6.0, point to Microsoft Visual Studio 6.0 Enterprise Tools, and then click Visual Studio Installer. On the New tab of the New Project dialog box, expand the Visual Studio folder and then click the Visual Studio Installer Projects folder. Click the Empty Installer icon, type a name for your new project in the Name box, type a path in the Location box that indicates where you want to build the new project, and then click Open. In the Project Explorer window, double-click Registry. Expand the Registry on Target Machine folder, and then expand the HKEY_CURRENT_USER folder. Right-click the SOFTWARE folder, point to New, and then click Key. Rename the New Key #1 folder to Microsoft.</li> Right-click the newly created Microsoft folder, point to New, and then click Key. Rename the New Key #1 folder to Office.</li> Right-click the newly created Office folder, point to New, and then click Key. Rename the New Key #1 folder to Common.</li> Right-click the newly created Common folder, point to New, and then click Key. Rename the New Key #1 folder to Smart Tag.</li> Right-click the newly created Smart Tag folder, point to New, and then click Key. Rename the New Key #1 folder to Actions.</li> Right-click the newly created Actions folder, point to New, and then click Key. Rename the New Key #1 folder to the name of your smart tag DLL, followed by a period, followed by the name of your smart tag action class file, minus any file extensions. For example, if the name of your smart tag DLL is &quot;MyFirstSmartTag&quot; and the name of your smart tag action class file is &quot;SmartTagAction&quot;, the name of the key would be MyFirstSmartTag.SmartTagAction.</li> Right-click the Smart Tag folder you created in step 9, point to New, and then click Key. Rename the New Key #1 folder to Recognizers.</li> Right-click the newly created Recognizers folder, point to New, and then click Key. Rename the New Key #1 folder to the name of your smart tag DLL, followed by a period, followed by the name of your smart tag recognizer class file, minus any file extensions. For example, if the name of your smart tag DLL is &quot;MyFirstSmartTag&quot; and the name of your smart tag action class file is &quot;SmartTagRecognizer&quot;, the name of the key would be MyFirstSmartTag.SmartTagRecognizer.</li> In the Project Explorer window, right-click Files, point to Add, and then click File(s). Browse to the smart tag DLL you want to install on the end user's computer, and then click Open.</li> On the Build menu, click Build.NOTE: If you receive error messages such as &quot;The install dialog Welcome is invalid&quot; when you click Build, you may have a mismatched version of a file named Mergemod.dll that ships with Visual Studio Installer. For additional information on how to resolve this issue, click the following article number to view the article in the Microsoft Knowledge Base:

281650 BUG: Cannot Compile VSI Project - 'Install Dialog' Errors

</li> Using Windows Explorer, browse to the path you created in step 3. In that path you will find a folder named Output. Open the Output folder, and then open the folder named DISK_1. In this folder you will find a file with the .msi extension. This is the Visual Studio Installer file you will distribute to end users. To install and register your smart tag DLL, end users must simply double-click the .msi file and accept the defaults that the Setup Wizard suggests.</li></ol>

Next Steps
Visual Studio Installer provides a rich set of installation dialog boxes and inserts an entry into the end user's Add/Remove Programs applet for uninstall or repair actions.

back to the top

<div class="references_section">