C development

To develop programs in C using the MQe Development Kit, you need the following tools:
Microsoft® eMbedded Visual C++ (EVC) Version 3.0.
This is included in Microsoft eMbedded Visual Tools 3.0, which is available as a free download from the Microsoft web page:
http://msdn.microsoft.com/mobile/
You must use version 3.0 as version 4.0 does not support PocketPC.
An SDK for your chosen platform
Microsoft eMbedded Visual Tools 3.0 includes an SDK for PocketPC 2000. You can also download an SDK for PocketPC 2002 from Microsoft:
http://msdn.microsoft.com/mobile/

C Bindings

For the C Bindings code base, see the C Bindings Programming Reference.

Native C

For general information see C Programming Reference, in particular the page Compilation Information. However, that page is now slightly out of date and this topic provides an update.

For the native C code base, support is provided for four platforms:
  • PocketPC2000
  • PocketPC2002
  • PocketPC2003
  • Windows® 32bit.
For PocketPC, binaries are provided for both the device and the emulator that is available in the Integrated Development Environment Microsoft eMbedded Visual C++. The binaries provided for the devices are compiled for ARM processors.
Binary files

The root of the binary files, as well as the documentation and examples, is the C directory below the directory where you choose to install MQe.

Then in the C directory, the files are located as follows:

PocketPC2000
ARM
DLLs
C\PocketPc2000\arm\bin
LIBs
C\PocketPc2000\arm\lib
Emulator
DLLs
C\PocketPc2000\x86emulator\bin
LIBs
C\PocketPc2000\x86emulator\lib
PocketPC2002
ARM
DLLs
C\PocketPc2002\arm\bin
LIBs
C\PocketPc2002\arm\lib
Emulator
DLLs
C\PocketPc2002\x86emulator\bin
LIBs
C\PocketPc2002\x86emulator\lib
PocketPC2003
ARM
DLLs
C\PocketPc2003\arm\bin
LIBs
C\PocketPc2003\arm\lib
Emulator
DLLs
C\PocketPc2003\x86emulator\bin
LIBs
C\PocketPc2003\x86emulator\lib
Windows 32bit
DLLs
C\Win32\Native\bin
LIBs
C\Win32\Native\lib
Header files

The header files are common to all the Native platforms, and can be found in the include directory below the installation directory.

MQe_API.h

This is the "root" header file. If this is included all relevant header files included for you.

In order to ensure the correct files and definitions are included you must indicate that you are running the Native code base as follows:
#define   NATIVE                   // or specify this as an option to the compiler
#include  <published/MQe_API.h>
Linking

You need to link against the following two libraries:

HMQ_nativeAPI.lib
// the API library
HMQ_nativeCnst.lib
// the static constant MQeString library

You need to include both these files. Then an optimizing linker removes links to any functions and constants that you have not used.

The other MQe libraries are statically and dynamically linked with the main API library and are included as required.


Terms of use | WebSphere software

(c) Copyright IBM Corporation 2004, 2005. All rights reserved.