How to: Register Customized Messaging Forms

Article
08/29/2006

Customized messaging forms require two separate registry entries. The first one registers the form COM server as a message class. This gives the Messaging application the information it needs to locate the plug-in DLL and extract the read and compose forms for displaying and creating messages. The second entry specifies the message transport(s) to use.

Note For information on how to work with the Windows CE registry, see Registry Fundamentals in the Windows CE documentation.

To register the form as a message class

Create and save a new registry key with the following registry key structure. In the key, replace <MessageClass> with the fully-qualified message class name of your form.

[HKEY_CURRENT_USER\Software\Microsoft\Inbox\MsgTypes\<MessageClass>]
    "GlyphInfo" = REG_BINARY: Glyph data for the list view icon.
    "DLL" = REG_SZ: The name of the DLL containing the form factory 
                    and read and compose forms.
    "Name" = REG_SZ: A user friendly name for the form.

Example

The following example demonstrates how to register a ticktacktoe game as a message class. The fully qualified message-class name includes the subfolder names. In this example, TicTacToe lives beneath the IPM (interpersonal messages) tree.

[HKEY_CURRENT_USER\Software\Microsoft\Inbox\MsgTypes\IPM\SMStext\TicTacToe]
    "GlyphInfo" = 20,00,00,00,64,00,00,00,64,00,00,00,00,00,00,00,01,00,
                  00,00,03,00,00,00,02,00,00,00,00,00,00,00
    "DLL" = "TicTacToe.dll"
    "Name" = "TicTacToe"

To register the list of supported messaging transports

Create and save a new registry key with the following registry key structure. In the key, replace <TransportType> with SMS, IMAP4, POP3, or a customized transport type.

[HKEY_LOCAL_MACHINE\Software\Microsoft\Inbox\Svc\<TransportType>\MsgClasses]
    "MessageType" = REG_DWORD: An integer specifying the preferred order 
                               to process the message types.

Example

The following example demonstrates how to register the TicTacToe game to use the SMS message transport.

[HKEY_LOCAL_MACHINE\Software\Microsoft\Inbox\Svc\SMS\MsgClasses]
    "IPM.SMStext.TicTacToe" = "1"

How to: Register Customized Messaging Forms

Example

Example

See Also

Additional resources