Registering a Parser

Because each wireless service provider determines the format for e-mail messages sent by it, parsing is done by functions stored in DLLs. MSDefault selects the DLL to invoke, based on the device and address on which the message was received. MSDefault uses the following criteria to determine which DLL to use:

• If a DLL is specified for a device address, the device DLL is used.
• If no DLL is specified for an address but one is specified for the device, the device DLL is used.
• If no DLL is specified for either the address or the device but one is specified as the default, the default parser is used.
• If no DLL is defined as the default, a system default parser is used.

The registry entries are stored under the key HKEY_LOCAL_MACHINE\Software\Microsoft\WIS\EmailParser. For example, consider a Windows CE–based device that has two radio devices, Device 1 and Device 2. Device 1 has three addresses, Tstaddr1, Tstaddr2, and Tstaddr3. The Windows CE–based device has the following registry entries.

    HKEY_LOCAL_MACHINE\Software\Microsoft\WIS\Control
    "EmailParser"="empdef.dll"
    HKEY_LOCAL_MACHINE\Software\Microsoft\WIS\Control\Device1
    "EmailParser"="empdev.dll"
    HKEY_LOCAL_MACHINE\Software\Microsoft\WIS\Control\Device1\Tstaddr1
    "EmailParser"="empcue.dll"
    HKEY_LOCAL_MACHINE\Software\Microsoft\WIS\Control\Device1\Tstaddr2
    "EmailParser"="emp2.dll"

No parser has been defined for Tstaddr3 or Device 2. In this example, the following DLLs would be selected for messages:

• If a message is received on any address of Device 2, Empdef.dll is used to parse the message.
• If a message is received on Tstaddr2 of Device 1, Emp2.dll is used to parse the message.
• If a message is received on Tstaddr3 of Device 1, Empdev.dll is used to parse the message.

In this example, because a default parser has been defined, the system default parser is never called for any message.