Secure Card Reader Authenticator API PROGRAMMING REFERENCE MANUAL MANUAL PART NUMBER 99875535-1 FEBRUARY 2011 REGISTERED TO ISO 9001:2008 1710 Apollo Court Seal Beach, CA 90740 Phone: (562) 546-6400 Technical Support: (651) 415-6800 www.magtek.
Copyright© 2004 – 2011 MagTek®, Inc. Printed in the United States of America Information in this document is subject to change without notice. No part of this document 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, Inc. Microsoft® is a trademark of Microsoft, Inc. REVISIONS Rev Number 1.
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 THE ABOVE ADDRESS, ATTENTION: CUSTOMER SUPPORT.
TABLE OF CONTENTS SECTION 1. OVERVIEW ............................................................................................................................. 1 SCRA METHODS ..................................................................................................................................... 1 SCRA EVENTS ......................................................................................................................................... 1 SCRA ENUMS ..................................
SECTION 1.
ImageSafe Windows API Specifications 2
SECTION 2. SECURE CARD READER AUTHENTICATOR API MTUSCRAOPENDEVICE This function opens a SCRA Swipe Reader Syntax MTUSCRA_API DWORD WINAPI MTUSCRAOpenDevice(LPSTR lpDeviceName); Parameter lpDeviceName Name of the device to open for future use. Current users should pass an empty string.
ImageSafe Windows API Specifications MTUSCRAGETCARDDATA This function retrieves card data information through a predefined structure Syntax MTUSCRA_API DWORD WINAPI MTUSCRAGetCardData(MTMSRDATA* lpMTMSRDATA); Parameter MTMSRDATA MSR Data Structure Return Values: Please see EErrorValues typedef struct _MTMSRDATA { char m_szCardData[DEF_MSR_DATA_LEN * 3];//Card Data char m_szCardDataMasked[DEF_MSR_DATA_LEN * 3]; //Masked Card Data char m_szTrack1Data[DEF_MSR_DATA_LEN];//Track 1 Data char m_szTrack2Data[DEF_
Section 2.
ImageSafe Windows API Specifications MTUSCRACARDDATASTATECHANGEDNOTIFY This function sets a callback function to notify card data states. Syntax TUSCRA_API void WINAPI MTUSCRACardDataStateChangedNotify(CallBackCardDataStateChanged lpFuncNotify); Parameter lpFuncNotify Function to call to provide notification information Return Values: None MTUSCRADEVICESTATECHANGEDNOTIFY This function sets a callback function to notify device states. Please refer to enum section for possible values.
Section 2. Excella Architecture and Operation MTUSCRAGETDEVICESTATE This function retrieves current device state information. For details on device states, please refer to the EDeviceStateValues Syntax MTUSCRA_API void WINAPI MTUSCRAGetDeviceState(DWORD* lpdwDeviceState) ; Return Values: None MTUSCRAGETCARDDATASTATE This function retrieves current device state information.
ImageSafe Windows API Specifications 8
