Message Queuing

Article
08/28/2006

This code sample is named MSMQ. It demonstrates how to implement Message Queuing (MSMQ).

Note You must first install the MSMQ.ARM.CAB file onto the mobile device before running this sample. You get this cab file when you download Optional Windows Mobile 5.0 Server Components.exe from the Mobile Developer Center.

Feature Area

Message Queuing

Relevant APIs

MSMQ API
MSMQAdm.exe utility

Usage

You must first install the MSMQ.ARM.CAB file onto the mobile device before running this sample. You get this cab file when you download Optional Windows Mobile 5.0 Server Components.exe from the Mobile Developer Center.

To setup the mobile device

Execute the file Optional Windows Mobile 5.0 Server Components.exe. The MSMQ.ARM.CAB file is unpacked and copied to a folder beneath the current folder.
Copy the MSMQ.ARM.CAB file onto the mobile device. You can place it in the \My Documents folder.
Run the MSMQ.ARM.CAB file on the device. The MSMQ driver and administration tools are extracted and installed on the mobile device.
If the mobile device does not already have a unique name, give it one now. You do this from Start > Settings > System > About > Device ID.
On the mobile device, use File Explorer to navigate to the \windows folder, and run the executable file VisAdm.exe. This is the MSMQ Administration application, and it allows you to configure the MSMQ service.
In the MSMQ Administration application, tap Shortcuts.
Tap Install. There is no indication for success.
Tap Register. A GUID is displayed, or if it is already registered, then a warning is displayed.
Soft-reset the mobile device.
On the mobile device, once again, run the executable file VisAdm.exe.
In the MSMQ Administration application, tap Shortcuts.
Check to make sure that the MSMQ service is running correctly. Do this by tapping Verify., and by tapping Status. If the service appears to be running properly, then you can proceed with running the code sample.

To run the code sample

Navigate to the solution file (*.sln), and double-click it. By default, the solution files are copied to the following folders:

C:\Program Files\Windows CE Tools\wce500\Windows Mobile 5.0 Pocket PC SDK\Samples\CPP\Win32\Msmq\VisAdm\``VisAdm.sln

C:\Program Files\Windows CE Tools\wce500\Windows Mobile 5.0 Smartphone SDK\Samples\CPP\Win32\Msmq\VisAdm\``VisAdm.sln

Microsoft Visual Studio 2005 launches and loads the solution.
Build the solution (Ctrl+Shift+B).
Deploy the solution (F5).

Remarks

MSMQ is a visual wrapper around MSMQADM.exe.

Requirements

Pocket PC SDK: Windows Mobile 5.0 Pocket PC SDK.
Smartphone SDK: Windows Mobile 5.0 Smartphone SDK.
Development Environment: Visual Studio 2005.
ActiveSync: Version 4.0.