Microsoft KB Archive/122787

{|
 * width="100%"|

SAMPLE: FileAsso.exe Demonstrates How to Use File Associations

 * }

Q122787

-

The information in this article applies to:


 * Microsoft Win32 Software Development Kit (SDK)
 * Microsoft Windows Software Development Kit (SDK) 3.1

-

SUMMARY
Windows provides file associations so that an application can register the type of documents it supports. This is beneficial because it allows the user to double-click or select a document in File Manager to edit it or print it. File association is also supported by the ShellExecute API. File associations also allow the user to open multiple documents with a single instance of the application through the File Manager.

ShellExecute has even more benefit in Windows 95.

MORE INFORMATION
The following file is available for download from the Microsoft Download Center:

"FileAsso.exe" For additional information about how to download Microsoft Support files, click the article number below to view the article in the Microsoft Knowledge Base:

"Q119591 How to Obtain Microsoft Support Files from Online Services" Microsoft used the most current virus detection software available on the date of posting to scan this file for viruses. Once posted, the file is housed on secure servers that prevent any unauthorized changes to the file.

The following information applies to both File Open and File Print. For ease of reading, this article discusses File Open to explain how file associations work.

When the user double-clicks a document, the File Manager calls ShellExecute with filename. ShellExecute checks the Registration Database for an entry that associates that file extension with a particular application. If an entry exists and does not specify DDE commands, then ShellExecute launches the application as specified in the registry. If the registry specifies to use DDE commands, ShellExecute attempts to establish a DDE conversation with that application using the application topic. If an application responds to the DDE connections, ShellExecute sends a DDE Execute command, as specified in the registry. It is up to the application to define the specifics on this conversation, particularly the service and topic name to connect to, and also the correct DDE execute command syntax to use. However, if attempts to establish the conversation fail, ShellExecute launches the application specified in the registry and tries to establish the DDE connection again.

There is one more option available when the application is not running, which seems to be appropriate for File Print. In this option, ShellExecute sends a different Execute statement, the application needs to Open and Print the document. When the Printing is done, it exits.

There are two steps for an application to open multiple documents through single application instance via File association. As an example, assume MyApp is the application and AssocSupport is the topic. Most applications use MyApp as their application name and System as the topic.


 * 1) When the application starts, register a DDE Server with the application name and topic (for example MyApp, and AssocSupport). The application also has to support DDE Execute Statements. The execute statement could be any format; at minimum, it should be:

 

Here  is anything specifying unique identification of the action, such as Open or Print. The  is the file that should be operated on. Finally, can be any options that need to be passed on.

A typical Execute Statement follows this format:

[()]

For example, Microsoft Word uses:

[Open("%1")] The Application has to support the required functionality for executed statements.
 * 1) File association can be done in Windows NT via File Manager or regedit.

Using the File Manager to Set File Associations
When associating a file type using the File Manager, choose Associate from the File menu. The Associate dialog presents the list of existing file associations. This dialog allows you to add a new file type (or file association), modify an existing file type, or delete an existing file type. The New File Type button allows the user to add an association for a new file extension. Here are the steps:


 * 1) Add a File type name. For example, name it "Microsoft Word 6.0 Document."
 * 2) Choose an action (Open or Print). For example, select the Uses DDE check box.
 * 3) Add the directory path and application name. For example, enter WINWORD as the application.
 * 4) Select the Uses DDE option.
 * 5) Set the Application as the DDE Server Name.
 * 6) Set the Topic as the DDE Server. For example, enter System as the Topic.
 * 7) Set the DDE Message   to be the same as your application's Execute Statement. However the  and should be replaced by whatever the command line arguments are. For example use:

DDE Message : [FileOpen("%1")]

Using Regedit in Windows NT to Set File Associations
NOTE: Regedit is available only in Windows NT, not in Windows version 3.1.

The user can also associate files with an application by using regedit. From the Edit menu, choose Add File Type or Modify File Type (to modify an existing file type). A dialog similar to File Manager Associate dialog appears. Follow the same steps as described for File Manager. In Windows version 3.1, once you have defined a File Type via this method, go to the File Manager associate dialog and attach the file type to the extension.

Using a Program to Set File Associations
You can also set the associations programmatically. This is useful when setting up your application on other machines. You can provide this functionality through your installation program. The first way to do this (the simpler method) is to use regedit to merge the changes from a file. The syntax for this is:

  regedit .reg An example of a .reg is:

  REGEDIT HKEY_CLASSES_ROOT\.riy = FMA000_File_assoc HKEY_CLASSES_ROOT\FMA000_File_assoc = File_assoc HKEY_CLASSES_ROOT\FMA000_File_assoc\shell\open\command = fileasso.EXE HKEY_CLASSES_ROOT\FMA000_File_assoc\shell\open\ddeexec = [Open(%1)] HKEY_CLASSES_ROOT\FMA000_File_assoc\shell\open\ddeexec\application = Myserver HKEY_CLASSES_ROOT\FMA000_File_assoc\shell\open\ddeexec\topic = system HKEY_CLASSES_ROOT\FMA000_File_assoc\shell\print\command = fileasso.EXE HKEY_CLASSES_ROOT\FMA000_File_assoc\shell\print\ddeexec = [Open(%1)] HKEY_CLASSES_ROOT\FMA000_File_assoc\shell\print\ddeexec\application = MYServer HKEY_CLASSES_ROOT\FMA000_File_assoc\shell\print\ddeexec\topic = System HKEY_CLASSES_ROOT\FMA000_File_assoc\shell\print\ddeexec\ifexec = [Test(%1)] In the program, you can also add keys to the registry by using the registry APIs. The developer needs to add the following keys to the registration database:

  // Your extensions. HKEY_CLASSES_ROOT\.riy = FMA000_File_assoc

//File type name. HKEY_CLASSES_ROOT\FMA000_File_assoc = File_assoc

// Command to execute when application is not running or dde is not // present and Open command is issued. HKEY_CLASSES_ROOT\FMA000_File_assoc\shell\open\command = fileasso.EXE

// DDE execute statement for Open. HKEY_CLASSES_ROOT\FMA000_File_assoc\shell\open\ddeexec = [Open(%1)]

// The server name your application responds to. HKEY_CLASSES_ROOT\FMA000_File_assoc\shell\open\ddeexec\application = Myserver

// Topic name your application responds to. HKEY_CLASSES_ROOT\FMA000_File_assoc\shell\open\ddeexec\topic = system

// Command to execute when application is not running or dde is not // present and print command is issued. HKEY_CLASSES_ROOT\FMA000_File_assoc\shell\print\command = fileasso.EXE

// DDE execute statement for Print. HKEY_CLASSES_ROOT\FMA000_File_assoc\shell\print\ddeexec = [Open(%1)]

// The server name your application responds to. HKEY_CLASSES_ROOT\FMA000_File_assoc\shell\print\ddeexec\application = MYServer

// Topic name your application responds to. HKEY_CLASSES_ROOT\FMA000_File assoc\shell\print\ddeexec\topic = System

// DDE execute statement for print if the application is not already // running. This gives the options for a an application to Run, Print // and Exit. HKEY_CLASSES_ROOT\FMA000_File assoc\shell\print\ddeexec\ifexec = [Test(%1)]