New Messaging Transport
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
8/28/2008
This code sample is named TransportDemo. It demonstrates how to create a custom messaging transport application for Windows Mobile 6 Professional and Windows Mobile 6 Classic.
Feature Area
Relevant APIs
- Messaging API (MAPI) API
- IMailSyncHandler interface
- IMailSyncCallBack interface
Usage
To run the code sample
Navigate to the solution file (*.sln), and double-click it. By default, the solution file is copied to the following folder:
C:\Program Files\Windows Mobile 6 SDK\Samples\PocketPC\CPP\win32\TransportDemoMicrosoft Visual Studio 2005 launches and loads the solution.
Build the solution (Ctrl+Shift+B).
Deploy the solution (F5).
To install the transport using a CAB
Copy the installation CAB to the My Documents folder in the Windows Mobile Emulator. You will need to use the Remote File Viewer tool that can be found in the Visual Studio 2005 Start Menu..
In the emulator, click Start > Programs > File Explorer > My Documents > TransportDemoSetup.cab. Wait for the installation to complete.
Start the Messaging application (Start > Messaging).
Create a new account (Menu > Tools > New Account).
Enter an e-mail address that uses the custom transport.
Click Next.
Click Next.
Enter the username and password for the email account using the custom transport.
Click Next.
Select the Custom Transport from the Account Type drop down.
Complete the remainder of the e-mail setup according to the custom transport messaging account settings.
To manually install the transport (without using a CAB)
Copy the transport DLL to the
\Windowsdirectory on the mobile device or in the emulator.Set these registry keys using the Remote Registry Editor tool that can be found in the Visual Studio 2005 Start Menu.. Note that the key name "TransportDemo" must match the value for "Name" here.
[HKEY_LOCAL_MACHINE\Software\Microsoft\Inbox\Svc\] "Name"="" "DLL"="TransportDemo.dll" "Port"=dword:00000000Start the messaging application (Start > Messaging).
Create a new account (Menu > Tools > New Account).
Enter an e-mail address that uses the custom transport.
Click Next.
Click Next.
Enter the username and password for the email account using the custom transport.
Click Next.
Select the Custom Transport from the Account Type drop down.
Complete the remainder of the e-mail setup according to the custom transport messaging account settings.
When you build the solution, a setup file is created. You can launch it to configure all of the registry settings, and install the DLL.
To install the transport using the generated INF file
On your workstation, navigate to the subfolder:
\Transportdemo\Transportdemosetup\Debug\.Double-click the file
TransportDemoSetup.inf.
Remarks
The transport in this code sample does not actually synchronize e-mail using a protocol. It just demonstrates how to construct a messaging transport.
Development Environments
SDK: Windows Mobile 6 Professional SDK and Windows Mobile 6 Standard SDK
Development Environment: Visual Studio 2005.
ActiveSync: Version 4.5.
See Also
Concepts
Code Samples for Windows Mobile
Other Resources
Messaging Transports
Registering Customized Messaging Transports