Share via


How to: Register Customized Messaging Forms

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"

See Also

Messaging Forms

Messaging Overview

Messaging

How to: Register Customized Messaging Rules Clients

How to: Register Customized Messaging Transports

Messaging Sample Code

Last updated on Friday, April 22, 2005

© 2005 Microsoft Corporation. All rights reserved.

Send feedback on this topic to the authors.