MagTek EC2000 99875713 - Manual (Page 6)

1 - Introduction
ExpressCard 2000| Instant Issuance Card Personalization System | Programmer’s Reference (Windows SDK)
Page 6 of 21
1.2 About Communicating With EC2000
EC2000 is a networked device which receives transactions from card personalization software in the form
of HTTPS requests sent to specific URLs in its internal web server, using XML formatted according to a
specification developed by MagTek. Developers of card personalization software have two options for
generating these HTTPS requests in their custom software:

They can construct XML and send HTTPS requests directly.

They can use the MagTek ExpressCard SDK provided in mtecsdk.dll.
Both options provide the same set of features, and from the device’s perspective both methods are
practically identical, apart from possible deviations in the exact XML format and content. The advantage
of using the ExpressCard SDK is that it abstracts implementation details, such as the physical connection
to the device and the creation and structure of the transaction XML. This abstraction can reduce the
overall maintenance cost of custom card personalization software.
This document serves primarily as a reference for the second method (constructing requests using the
MagTek ExpressCard Windows SDK), which requires 33090060 ExpressCard Software Development
Kit, available from MagTek. For information about sending XML requests directly, see 99875611
ExpressCard 2000 Programmer’s Reference (XML), available from MagTek.
1.3 About mtecsdk.dll
mtecsdk.dll provides a high-level API to communicate with the device. It completely encapsulates
calls to msxml4.dll to convert transactions into XML, as well as calls to wininet.dll for network
communication. mtecsdk.dll also provides functions to convert the XML responses from the device
into key-value pairs that can be easily retrieved without parsing the XML.
1.4 How to Use the ExpressCard SDK in Software Projects
To use the ExpressCard SDK in a custom software project, follow these steps:
1) Download 33090060 ExpressCard Software Development Kit (SDK), available from MagTek.
2) Run the setup program to install the SDK on your development workstation, noting the full
installation directory path. By default, the SDK installs to C:\Program Files
(x86)\MagTek\ExpressCard (SDK) Demo, and supporting files install to various other Windows
library locations.
3) Ensure the files listed in Table 1-1 have successfully been copied to the specified locations.
4) Create or open your custom software project in Visual Studio.
5) If your chosen programming language links using .h files, include mtecsdk.h located in the root
installation location of the ExpressCard SDK.
6) If your chosen programming language links using .lib files, include mtecsdk.lib located in the root
installation location of the Expresscard SDK.
7) If your chosen programming language links directly to .dll files, include mtecsdk.dll located in
C:\Windows\SysWOW64 on 64-bit workstations or C:\Windows \System32 on 32-bit workstations.
Table 1-1 - Files Required for ExpressCard SDK
File Location Description
mtecsdk.ini C:\Windows This file contains a list of default ExpressCard
connections and IP addresses. This file is required
by mtecsdk.dll.