Custom Messages Entries for Mail

This subkey is similar in many ways to the Custom Commands subkey. Each entry specifies a custom message type to be installed into a Mail menu at run-time.

These entries can appear both in the Microsoft Mail key and in the SHARED32.INI file in the directory defined by the SharedExtensionsDir entry under the Microsoft Mail key.

This is the Registry path for this subkey:


HKEY_CURRENT_USER\Software\Microsoft\Mail\Custom Messages

The Custom Messages subkey can contain one or more of the following entries.

class REG_SZ

Specifies a string uniquely identifying the message type. Mail places this string in messages and calls custom message DLLs based on its value. Each entry is in the following format:


class = version;menu;name;position;DLL name;command;operation map;
status text;Help file;help context;

Value

Meaning

version

The version of Mail in which the custom message is compatible.

menu

The menu where the custom command for the message type is to be added, such as File or Mail.

name

The command name to appear on the menu. Include an ampersand just before the letter that is to serve as an ALT+key accelerator.

position

The zero-relative position within its menu at which the command is to appear. A value of –1 places the command at the end of the menu.

DLL name

Name or path of the DLL in which the custom command resides.

command

Command string passed as one of the parameters to the DLL entry point for the command.

operation map

Sequence of up to 16 digits. Each can be 0, 1, or 2, where 0 indicates that Mail is to perform its standard operation on the custom message. 1 indicates that the DLL is to be called to handle the operation. 2 indicates that the operation is to be completely disabled. Currently eight operations are defined; the rest are reserved and must be zero. In the following list, 0 is the leftmost digit:

0 Compose (menu command defined in this entry)
1 File.Open
2 Mail.Reply
3 Mail.Reply to All
4 Mail.Forward
5 File.Print
6 File.Save as
7 Arrival of new mail

status text

Text to be displayed in the Mail status bar when the user highlights the command in the menu.

Help file

Windows NT Help file to be invoked when the user presses F1 while the command is selected. The specified filename is passed to the Windows NT Help program. (optional)

help context

Passed to the Windows NT Help program along with the Help filename. Use –1 (Help file index) if there is no specific entry in the Help file for this command. (optional)

<ExtsDir>

A special token that can appear within certain fields. Expands to the value of SharedExtensionsDir in the Microsoft Mail key. Used to refer to DLLs that are installed in a shared extensions directory on the network. Valid for the DLL name, command, and Help file fields.