Registering Customized Messaging Forms

  • Article

Send Feedback

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.

Code Example

The following code 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.

Note   To make the following code example easier to read, security checking and error handling are not included. This code example should not be used in a release configuration unless it has been modified to include them.

[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.
Code Example

The following code example demonstrates how to register the TicTacToe game to use the Short Message Service (SMS) message transport.

Note   To make the following code example easier to read, security checking and error handling are not included. This code example should not be used in a release configuration unless it has been modified to include them.

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

See Also

How to Create a Messaging Application | Messaging Application Development for Windows Mobile-based Devices | Messaging | Messaging Sample Code | Messaging Forms | How to: Register Customized Messaging Transports | How to: Register Customized Messaging Rules Clients

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.