background image

 

REGISTERED TO ISO 9001:2000 

1710 Apollo Court, Seal Beach, CA 90740 

MagTek Part Number 99875367-1 

Voice: 310-631-8602   Fax: 310-631-3956 

06 Sept 2007 

 

SOFTWARE LICENSE AGREEMENT 

 

IMPORTANT: YOU SHOULD CAREFULLY READ ALL THE TERMS, CONDITIONS AND RESTRICTIONS OF THIS LICENSE AGREEMENT 
BEFORE INSTALLING THE SOFTWARE PACKAGE. YOUR INSTALLATION OF THE SOFTWARE PACKAGE PRESUMES YOUR ACCEPTANCE 
OF THE TERMS, CONDITIONS, AND RESTRICTIONS CONTAINED IN THIS AGREEMENT. IF YOU DO NOT AGREE WITH THESE TERMS, 
CONDITIONS, AND RESTRICTIONS, PROMPTLY RETURN THE SOFTWARE PACKAGE AND ASSOCIATED DOCUMENTATION TO ABOVE 
ADDRESS ATTENTION: CUSTOMER SUPPORT. 

 

TERMS, CONDITIONS AND RESTRICTIONS 

 

MagTek, Incorporated (the "Licensor") owns and has the right to distribute the described software and documentation, collectively referred to as the 
"Software". 

 

LICENSE:

 

Licensor grants you (the "Licensee") the right to use the Software in conjunction with MagTek products. 

 

 

LICENSEE MAY NOT COPY, MODIFY OR TRANSFER THE SOFTWARE IN WHOLE OR IN PART EXCEPT AS EXPRESSLY PROVIDED IN THIS 
AGREEMENT. Licensee may not decompile, disassemble or in any other manner attempt to reverse engineer the Software. Licensee shall not tamper with, 
bypass or alter any security features of the software or attempt to do so. 

 

TRANSFER:

 

Licensee may not transfer the Software or license to the Software to another party without prior written authorization of the Licensor. If 

Licensee transfers the Software without authorization, all rights granted under this Agreement are automatically terminated. 

 

COPYRIGHT:

 

The Software is copyrighted. Licensee may not copy the Software except for archival purposes or to load for execution purposes. All other 

copies of the Software are in violation of this Agreement. 

 

TERM:

 

This Agreement is in effect as long as Licensee continues the use of the Software. The Licensor also reserves the right to terminate this Agreement if 

Licensee fails to comply with any of the terms, conditions or restrictions contained herein. Should Licensor terminate this Agreement due to Licensee's failure 
to comply, Licensee agrees to return the Software to Licensor. Receipt of returned Software by the Licensor shall mark the termination. 

 

 

LIMITED WARRANTY:

 

Licensor warrants to the Licensee that the disk(s) or other media on which the Software is recorded to be free from defects in 

material or workmanship under normal use. THE SOFTWARE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR 
IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
PURPOSE. Because of the diversity of conditions and PC hardware under which the Software may be used, Licensor does not warrant that the Software will 
meet Licensee specifications or that the operation of the Software will be uninterrupted or free of errors. 
 
IN NO EVENT WILL LICENSOR BE LIABLE FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL 
OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE. Licensee's sole remedy in the event of a 
defect in material or workmanship is expressly limited to replacement of the Software disk(s) if applicable. 

 

GOVERNING LAW:

 

If any provision of this Agreement is found to be unlawful, void or unenforceable, that provision shall be removed from 

consideration under this Agreement and will not affect the enforceability of any of the remaining provisions. This Agreement shall be governed by the laws of 
the State of California and shall insure to the benefit of MagTek, Incorpor

ated, its successors or assigns. 

 

 

ACKNOWLEDGMENT:

 

LICENSEE ACKNOWLEDGES THAT HE HAS READ THIS AGREEMENT, UNDERSTANDS ALL OF ITS TERMS, 

CONDITIONS AND RESTRICTIONS AND AGREES TO BE BOUND BY THEM. LICENSEE ALSO AGREES THAT THIS AGREEMENT 
SUPERSEDES ANY AND ALL, VERBAL AND WRITTEN, COMMUNICATIONS BETWEEN LICENSOR AND LICENSEE OR THEIR ASSIGNS 
RELATING TO THE SUBJECT MATTER OF THIS AGREEMENT. 

 

QUESTIONS REGARDING THIS AGREEMENT SHOULD BE ADDRESSED IN WRITING TO MAGTEK, INCORPORATED, ATTENTION: 
CUSTOMER SUPPORT, AT THE ABOVE ADDRESS OR E-MAILED TO 

[email protected]

iii 

Summary of Contents for EXPRESSCARD 1000

Page 1: ...RENCE MANUAL WINDOWS API SPECIFICATIONS MANUAL PART NUMBER 99875367 1 SEPTEMBER 2007 REGISTERED TO ISO 9001 2000 1710 Apollo Court Seal Beach CA 90740 Phone 562 546 6400 FAX 562 546 6301 Technical Sup...

Page 2: ...nt may be reproduced or transmitted in any form or by any means electronic or mechanical for any purpose without the express written permission of MagTek Inc MagTek is a registered trademark of MagTek...

Page 3: ...ditions or restrictions contained herein Should Licensor terminate this Agreement due to Licensee s failure to comply Licensee agrees to return the Software to Licensor Receipt of returned Software by...

Page 4: ...Error Reporting 12 Debugging API 12 SECTION 3 EXPRESSCARD 1000 API 13 MTECSDK_GetDevice 13 Parameters 13 Return Values 13 Remarks 13 Example 13 MTECSDK_OpenDevice 14 Parameters 14 Return Values 14 Re...

Page 5: ...Example 23 MTECSDK_GetAttribute 24 Parameters 24 Return Values 24 Remarks 24 Example 25 MTECSDK_LogEnable 26 Parameters 26 Return Values 26 Remarks 26 Example 26 MTECSDK_SetLogFileHandle 27 Parameter...

Page 6: ......

Page 7: ...module Mechanically embosses indents characters on card surface Exit module Exits completed card or stores rejected card in internal hopper Secure enclosure that can logically detect permit access to...

Page 8: ...nd status and functional aspects the device interface Of primary importance is to review the code samples contained in the appendices of this document The code samples provide clear instructions regar...

Page 9: ...tions used follow the illustration Application Figure 2 1 ExpressCard 1000 Software Architecture COMPUTER EXPRESSCARD 1000 DEVICE Wininet dll C API to xfer data to a web XML to Key Value and vice vers...

Page 10: ...to XML format using msxml4 dll and then send it to the device using wininet dll It also provides functions to convert the response from the device XML format to key value pairs msxml4 dll Microsoft XM...

Page 11: ...s of the ExpressCard 1000 device to obtain device capabilities information is followed Assuming the ExpressCard 1000 device has IP address 192 168 10 100 type the following line in the address box of...

Page 12: ...in device status information Assuming the ExpressCard 1000 device has IP address 192 168 10 100 type the following line in the address box of the Web browser Internet Explorer is used in this example...

Page 13: ...e usage information Assuming the ExpressCard 1000 device has IP address 192 168 10 100 type the following line in the address box of the Web browser Internet Explorer is used in this example https 192...

Page 14: ...r This file contains a list of default ExpressCard 1000 connections and IP addresses This file is required by the MTECSDK dll MTECSDK dll Windows System32 folder ExpressCard 1000 API wininet dll Windo...

Page 15: ...ends a process request to a given device to process card with given options 16 MTECSDK_QueryInfo Sends a request to a given device name to query for info on a given query parameter 18 MTECSDK_SendComm...

Page 16: ...Figure 2 4 illustrates the sequence of document processing ExpressCard 1000 Present Successful Open Device Select desired options for document processing Yes Yes Send Options to Device Check Completio...

Page 17: ...to send the process options to the ExpressCard 1000 device 5 ExpressCard 1000 processes the document with the given process options and returns the result of the process operation The result is stored...

Page 18: ...and return messages from the ExpressCard 1000 If an error occurs due to the failure of API function the error is returned as the return code of the API provided by MTECSDK dll The Windows XML Specific...

Page 19: ...EC_ST_DEVICE_NOT_FOUND EC_ST_BAD_PARAMETER Remarks If the function succeeds the return value is EC_ST_OK The device name of the device is filled in the buffer pointed by the parameter pcDevName If th...

Page 20: ...E_NAME EC_ST_DEVICE_NOT_FOUND EC_ST_DEVICE_NOT_RESPONDING EC_ST_MSXML_NOT_FOUND Remarks If the pcDevName is NULL the return value is EC_ST_BAD_DEVICE_NAME If no device is found the return value is EC_...

Page 21: ...Return Values EC_ST_OK EC_ST_BAD_DEVICE_NAME EC_ST_DEVICE_NOT_FOUND Remarks If the pcDevName is NULL the return value is EC_ST_BAD_DEVICE_NAME Example define DEVICE_NAME_LEN 128 int i 1 DWORD dwResult...

Page 22: ...ntaining the options to be used in processing the card The options are stored in the buffer by using function MTECSDK_SetValue pcDocInfo Pointer to the buffer containing the information returned from...

Page 23: ...ror results from bad connection with device can be one of the following EC_ST_CONNECT_REQUEST_TIMEDOUT EC_ST_REQUEST_TIMEDOUT EC_ST_DEVICE_NOT_RESPONDING EC_ST_ERR_INTERNET_CONNECT EC_ST_ERR_HTTP_OPEN...

Page 24: ...the section name e g Device Capabilities Device Usage DeviceStatus etc pcSectionData Pointer to the buffer that is used to store the data of the inquiry section pdwLength Specifies the size of the pc...

Page 25: ...from bad connection with device can be one of the following EC_ST_CONNECT_REQUEST_TIMEDOUT EC_ST_REQUEST_TIMEDOUT EC_ST_DEVICE_NOT_RESPONDING EC_ST_ERR_INTERNET_CONNECT EC_ST_ERR_HTTP_OPEN_REQUEST EC_...

Page 26: ...the pcOptions buffer Return Values EC_ST_OK EC_ST_NOT_ENOUGH_MEMORY EC_ST_BAD_DATA EC_ST_BAD_SECTION_NAME EC_ST_BAD_BUFFER_LENGTH Remarks The function returns EC_ST_NOT_ENOUGH_MEMORY if the pcOptions...

Page 27: ...using MTECSDK_SetValue function ULONG MTECSDK_GetValue char pcDocInfo char pcSection char pcKey char pcValue DWORD pdwLength Parameters pcDocInfo Buffer pointer containing all the key value pairs pcS...

Page 28: ...eter EC_ST_KEY_NOT_FOUND is returned Example char Settings 4096 char DocInfo 4096 char device 4096 DWORD SettingsBufferSize DWORD DocInfoSize char cValue 1024 DWORD valueSize DWORD dwStatus Initialize...

Page 29: ...ptions buffer Return Values EC_ST_OK EC_ST_NOT_ENOUGH_MEMORY EC_ST_BAD_DATA EC_ST_BAD_SECTION_NAME EC_ST_BAD_BUFFER_LENGTH Remarks The function returns EC_ST_NOT_ENOUGH_MEMORY if the pcOptions buffer...

Page 30: ...s the retrieved string pdwLength Specifies the size of the pcAttribute buffer Return Values EC_ST_OK EC_ST_NOT_ENOUGH_MEMORY EC_ST_ERR_LOAD_XML EC_ST_ERR_GET_DOM_POINTER EC_ST_BAD_DATA EC_ST_BAD_SECTI...

Page 31: ...tion MTECSDK_GetDevice to get device name for variable device Call MTECSDK_ProcessDoc function to process a document dwStatus MTECSDK_ProcessDoc device Settings DocInfo DocInfoSize if dwStatus MTEC_ST...

Page 32: ...unction MTECSDK_SetLogFileHandle and also a TRUE value is set for parameter of function MTECSDK_LogEnable By default logging is disable void MTECSDK_LogEnable BOOL bEnable Parameters bEnable a Boolean...

Page 33: ...Return Values No value is returned from this function Remarks Example define DEVICE_NAME_LEN 128 int i 1 DWORD dwResult HANDLE fileHandle char cDeviceName DEVICE_NAME_LEN while dwResult MTECSDK_GetDev...

Reviews: