Argox PT-9130 Programming Manual
Argox PT-9130 Programming Manual

Argox PT-9130 Programming Manual

Hide thumbs Also See for PT-9130:
Table of Contents

Advertisement

Quick Links

PT-9130 Mobile Computer
SDK Programming Manual
DOC NO. UM-PT905-01
July 2015
Version 2.0
© 2010-2012 ARGOX Information Co., Ltd.
http://www.argox.com

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the PT-9130 and is the answer not in the manual?

Questions and answers

Summary of Contents for Argox PT-9130

  • Page 1 PT-9130 Mobile Computer SDK Programming Manual DOC NO. UM-PT905-01 July 2015 Version 2.0 © 2010-2012 ARGOX Information Co., Ltd. http://www.argox.com...
  • Page 2: Table Of Contents

    Table of Contents OVERVIEW ............................................... 2 SDK FUNCTIONS ..........................................3 SYSAPIAX.DLL ............................................4 ....................................9 UDIO ELA TED UNCTIONS Audio_GetV olume ..................................9 Audio_SetV olume..................................10 .................................... 11 A TTERY ELA TED UNCTION GetBatteryStatus .................................... 11 ................................... 13 ISPLA Y ELA TED UNCTIONS BacklightOn ....................................
  • Page 3 UnRegisterAlphaKeyNotification ............................38 RegisterTriggerKeyNotification .............................. 39 UnregisterTriggerKeyNotification ............................40 ..................................41 IBRA TOR ELA TED UNCTIONS VibratorOn ..................................... 41 WLAN R ....................................42 ELA TED UNCTION WL_Enable ....................................42 WL_Disable ....................................43 ..................................44 LUETOOTH ELA TED UNCTION BT_On ......................................44 BT_Off......................................
  • Page 4 DeleteFTPFile ....................................78 .................................... 79 AMERA ELA TED UNCTION Camera_On ....................................79 Camera_Off ....................................80 SetPreviewSize ....................................81 GetPreviewSize ..................................... 82 EnablePreview ....................................83 SetStillCaptureSize ..................................84 GetStillCaptureSize ..................................85 StartStillCapture .................................... 86 SetFlash ......................................87 GetFlash ......................................88 SetDarkMode ....................................89 GetDarkMode ....................................
  • Page 5 GetPINLockStatus ..................................115 CheckPINCode ..................................116 CheckPUKCode ..................................117 ChangePINCode ..................................118 ReadPhonebook..................................119 WritePhonebook ..................................120 DeletePhonebook ..................................121 ReadMultiPhonebook ................................122 GetPhonebookT otal ..................................124 GetPhoneMaxLength ................................125 SendSMS .......................................126 ReadSMS ......................................127 DeleteSMS ....................................129 ReadMultiSMS ...................................130 WriteStorageSMS ..................................132 SendStorageSMS ..................................133 GetSMST otal ....................................134 SetSMSCentre .....................................135 GetSMSCentre ....................................136 SMS_Register ....................................137...
  • Page 6 ReadSingleBlock ..................................155 WriteSingleBlock ..................................156 WriteAFI ......................................157 WriteDSFID ....................................158 LockAFI ......................................159 LockDSFID ....................................160 LockBlock .....................................161 TagSystemInfo .....................................162 TagStayQuiet....................................163 TagSelect .......................................164 TagResetT oReady ..................................165 OpenCard14443A ..................................166 ReadMifareBlock ..................................167 WriteMifareBlock ..................................168 ReadUltraLightBlock ................................169 WriteUltraLightBlock ................................170 GetUid14443B ...................................171 SRIX4KChipID ..................................172 SRIX4KReadBlock ...................................173 SRIX4KWriteBlock ...................................174 RFID R ......................................175 EQUEST...
  • Page 7 S2K_Load ....................................195 SCAN_QueryStatus ..................................196 SCAN_SendCommand................................197 SCAN_ResumeSystem ................................198 SCAN_BatchSetting .................................199 SCAN_BatchRead ..................................200 ...................................201 ELA TED UNCTIONS PT_OpenScan2Key .................................201 PT_CloseScan2Key .................................202 PT_SetT oDefault ..................................203 ..................................204 CANNER ELA TED UNCTIONS PT_EnableScanner...................................204 PT_DisableScanner .................................205 PT_CheckBarcodeData .................................206 PT_GetBarcodeData ................................207 PT_SetDefault .....................................209 ..................................210 ELA TED UNCTIONS EnableTriggerKey ..................................210 GetLibraryV ersion ..................................
  • Page 8 Matrix25_Setting Structure ..............................233 UEGeneral_Setting Structure..............................234 IATA25_Setting Structure ................................235 Trioptic_Setting Structure ................................236 RSS_Setting Structure ................................237 SCAN COMMAND TABLE .......................................238 FUNCTION RETURN V ALUES .....................................246 PT-90 Mobile Computer SDK Programming Manual VIII...
  • Page 9: Overview

    Argox PT-90 Mobile Computers under Microsoft® Windows® CE6.0 Operating System. It gives all the details needed to call functional subroutines controling the devices on the Argox PT-90 Mobile Computer or access value-added devices on board such as Scanning and Wireless module.
  • Page 10: Sdk Functions

    SDK Functions When using SDK to develop their own application program, the programmer should link DLL file or LIB file, then, include header file SYSAPIAX.H. The following two examples are given to show how to use LIB file and DLL file while developing an application program.
  • Page 11: Sysapiax.dll

    SYSAPIAX.DLL In PT-90 SDK, we provide SYSAPIAX.DLL which includes several functions to allow programmer to control device drivers and system functions. Programmer can use WINCE develop tool like Visual Studio 2005 to develop application programs. Descriptions of all these functions are given below.
  • Page 12: Pt-90 Mobile Computer Sdk Programming Manual

    System Related Functions  CallSuspend – Enter SUSPEND mode.  EnableAutoConnect – Turn auto-connect ON or OFF.  RegisterAlphaKeyNotification – Register a request to send a prompt message when the ALPHA key is pressed.  ShowChineseIME – DISPLAY or HIDE the Chinese IME. ...
  • Page 13: Pt-90 Mobile Computer Sdk Programming Manual

     EndSearchBTDevice – frees the search handle.  InitSearchFTPDevice – Initial search the device supported FTP service.  FindFirstFTPDevice – Get first device supported FTP service position.  FindNextFTPDevice – Get next device supported FTP service position.  PairDevice – Pair with device. ...
  • Page 14: Getpinlockstatus

    GPRS Related Functions  GPRS_On – Enable GPRS.  GPRS_Off – Disable GPRS.  GetGPRSPowerStatus – Query GPRS current power status.  SendATCommand – Send AT command and verify required response.  GetATResponse – Get response from module buffer.  GetIMEINumber –...
  • Page 15: Readmultiphonebook

     ReadMultiSMS – Read multitude SMS messages.  WriteStorageSMS – Write a SMS message to memory storage.  SendStorageSMS – Send a SMS message from memory storage.  GetSMSTotal – Query SMS message amount, include used、total.  SetSMSCentre – Set phone number of SMS centre. ...
  • Page 16: Ela Ted Functions

    Audio Related Functions Audio_GetV olume To query the current audio volume level setting. DWORD Audio_GetV olume LPDWORD lpdwV olume Parameters lpdwV olume [out] The current volume level setting. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, the returned value is E_FUNC_ERROR.
  • Page 17: Audio_Setv Olume

    Audio_SetV olume To set the audio volume level. DWORD Audio_SetV olume DWORD dwV olume Parameters dwV olume [in] Specifies a new volume level setting. The default level is 0x99999999. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, the returned value is E_FUNC_ERROR.
  • Page 18: Battery Related Function

    Battery Related Function GetBatteryStatus To get main battery status. int GetBatteryStatus Parameters None. Returned V alues The returned value can be one of the values in the table below. Return value Description battery high battery low battery critical battery charging no battery battery unknown Example...
  • Page 19 case 3: AfxMessageBox(_T("Battery Charging")); break; case 4: AfxMessageBox(_T("No Battery")); break; case 5: AfxMessageBox(_T("Battery Unknown")); break; Requirements OS V ersions: Windows CE 6.0 or beyond Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 20: Display Related Functions

    Display Related Functions BacklightOn To turn ON or OFF the LCD screen back-light. DWORD BacklightOn BOOL Parameters [in] Flag that indicates whether to turn ON screen back-light(TRUE) or turn OFF screen back-light(FALSE). Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, the returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
  • Page 21: Display_Querybacklightintensity

    Display_QueryBacklightIntensity To return the back-light intensity of external power and battery power. DWORD Display_QueryBacklightIntensity LPDWORD lpdwACBacklight, LPDWORD lpdwBatteryBacklight Parameters lpdwACBacklight [out] The backlight intensity of external power. lpdwBatteryBacklight [out] The backlight intensity of battery power. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, possible returned values are E_FUNC_ERROR, E_FUNC_NULLPTR.
  • Page 22 Example DWORD dwResult, dwV alue1, dwV alue2; dwResult = Display_QueryBacklightIntensity(&dwV alue1, &dwV alue2); if(dwResult != E_FUNC_SUCCEED) AfxMessageBox(_T("Display_QueryBacklightIntensity fail")); else CString strTemp; strTemp.Format(_T("AC backlight intensity: %d, Battery backlight intensity: %d"), dwV alue1, dwV alue2); AfxMessageBox(strTemp); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll...
  • Page 23: Getbacklightstatus

    GetBacklightStatus To get screen back-light status. DWORD GetBacklightStatus Parameters None. Returned V alues The returned value indicates whether screen back-light is: 1 = screen back-light is ON; or 0 = screen back-light is oOFF. Example DWORD dwResult; dwResult = GetBacklightStatus(); if(dwResult == 1) AfxMessageBox(_T("Backlight on"));...
  • Page 24: Poweronlcd

    PowerOnLCD To turn ON or OFF the LCD screen power. DWORD PowerOnLCD BOOL Parameters [in] Flag that indicates whether to turn ON (TRUE) or OFF (FALSE) the LCD power. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
  • Page 25: Setbacklightpwm

    SetBacklightPWM To adjusts the LCD screen back-light brightness. DWORD SetBacklightPWM int nACPowerPercent, nBatteryPercent Parameters nACPowerPercent,nBatteryPercent [in] One is the brightness level setting when the terminal is using AC power and the other is the brightness level setting when the terminal is using battery power. These two settings must be one of the values in the table below.
  • Page 26: Enabletouchpanel

    EnableTouchPanel To ENABLE or DISABLE the touch panel. DWORD EnableTouchPanel BOOL bEnable Parameters bEnable [in] Flag that indicates whether to enable(TRUE) or disable(FALSE) the touch panel. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, possible returned values are E_FUNC_ERROR.
  • Page 27: Gettouchpanelstatus

    GetTouchPanelStatus To get touch panel status. DWORD GetTouchPanelStatus LPBOOL lpbEnable Parameters lpbEnable [out] Receive the touch panel status. The returned value can be one of the values in the table below V alue Touch panel status Touch panel disable Touch panel enable Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED.
  • Page 28: Keypad Related Functions

    KeyPad Related Functions EnablePowerButton To ENABLE or DISABLE the POWER button. DWORD EnablePowerButton BOOL Parameters [in] Flag that indicates whether to ENABLE the POWER button(TRUE) or to DISABLE the POWER button(FALSE). Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
  • Page 29: Getkeypadalphamode

    GetKeypadAlphaMode To get the current keypad INPUT mode. DWORD GetKeypadAlphaMode Parameters None. Returned V alues The returned value can be one of the values in the table below. Return value Alpha mode numeric mode lowercase letter mode uppercase lette mode Example DWORD dwResult;...
  • Page 30: Sendkbdvirtualkey

    SendKbdVirtualKey To send a VIRTUAL KEY to key buffer. DWORD SendKbdVirtualKey BYTE Parameters [in] Specifies a virtual-key code. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, possible returned value is E_FUNC_PAR_ERROR. Example CString strTemp;...
  • Page 31: Setkeypadalphamode

    SetKeypadAlphaMode To change keypad INPUT mode. DWORD SetKeypadAlphaMode nMode Parameters nMode [in] Flags for setting INPUT mode. This parameterer must be one of the values in the table below. Value Alpha mode numeric mode lowercase letter mode uppercase letter mode Returned V alues If this action succeeds, the returnedvalue is E_FUNC_SUCCEED.
  • Page 32: Led Related Functions

    LED Related Functions GetKeypadLEDStatus To get keypad back-light LED status. BOOL GetKeypadLEDStatus Parameters None. Returned V alues The returned value indicates whether keypad back-light LED is ON(TRUE) or OFF(FALSE). Example BOOL bResult; bResult = GetKeypadLEDStatus(); if(bResult == TRUE) AfxMessageBox(_T("Keypad LED on")); else if(bResult == FALSE) AfxMessageBox(_T("Keypad LED off"));...
  • Page 33: Goodreadledon

    GoodReadLEDOn To turn ON or OFF the goodread LED. DWORD GoodReadLEDOn BOOL Parameters [in] Flag that indicates whether to turn ON(TRUE) or OFF(FALSE) the goodread LED. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
  • Page 34: Keypadledon

    KeypadLEDOn To always turn ON or OFF the keypad LED. DWORD KeypadLEDOn BOOL Parameters [in] Flag that indicates whether to turn ON (TRUE) or OFF(FALSE) the keypad LED. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
  • Page 35: Querykeypadledintensity

    QueryKeypadLEDIntensity To return the Keypad LED Intensity Setting when using external power and using battery power. DWORD QueryKeypadLEDIntensity LPDWORD lpdwACKeypadLED, LPDWORD lpdwBatteryKeypadLED Parameters lpdwACKeypadLED [out] The Keypad LED Intensity Setting using external power. lpdwBatteryKeypadLED [out] The Keypad LED Intensity Setting using battery power. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED.
  • Page 36 Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 37: Setkeypadpwm

    SetKeypadPWM To adjusts Keypad LED Brightness. DWORD SetKeypadPWM int nACPowerPercent, nBatteryPercent Parameters nACPowerPercent,nBatteryPercent [in] One is to set Keypad LED Brightness setting when using AC power and the other is to set Keypad LED Brightness setting when using battery. These two parameters must be one of the values in the table below.
  • Page 38: System Related Functions

    System Related Functions CallSuspend To force the terminal entering SUSPEND mode. void CallSuspend Parameters None. Returned V alues None. Example //suspend device CallSuspend(); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 39: Enableautoconnect

    EnableAutoConnect To turn the AUTOCONNECT function ON or OFF. BOOL EnableAutoConnect BOOL bEnable Parameters bEnable [in] Flag that indicates whether ActiveSync is being automatically executed (TRUE) or not (FALSE) when user plugging host interface cable into the terminal. Returned V alues Returning TRUE if the operation is successful.
  • Page 40: Registeralphakeynotification

    RegisterAlphaKeyNotification To Register the application to SYSAPIAX.dll, so that SYSAPIAX.dll will send a window message to the application when the Alpha Key is pressed. DWORD RegisterAlphaKeyNotification HANDLE hWnd, UINT uMsg Parameters hWnd [in] The handling window of the application to receive the message. uMsg [in] The message value to be sent when Alpha Key is pressed.
  • Page 41: Showchineseime

    ShowChineseIME To SHOW or HIDE ChineseIME function display BOOL ShowChineseIME BOOL bShow Parameters bShow [in] Flag that indicates whether to SHOW(TRUE) or HIDE (FALSE) the Chinese IME function display. Returned V alues Returning TRUE if the operation is successful, otherwise FALSE. Remarks The Chinese IME is only supported in Chinese OS.
  • Page 42: Showdesktop

    ShowDesktop To SHOW or HIDE Desktop function icon display. BOOL ShowDesktop BOOL bShow Parameters bShow [in] Flag that indicates whether to SHOW(TRUE) or HIDE(FALSE) the Desktop function icon display. Returned V alues Returning TRUE if the operation is successful; otherwise FALSE. Remarks After calling this function with parameter FALSE, the terminal will HIDE all icons on Desktop.
  • Page 43: Showexploretoolbar

    ShowExploreToolbar To SHOW or HIDE Internet ExploreToolbar function display in Windows IE. BOOL ShowExploreToolbar BOOL bShow Parameters bShow [in] Flag that indicates whether to SHOW(TRUE) or HIDE(FALSE) the Internet Explorer toolbar in Windows IE. Returned V alues Returning TRUE if the operation is successful; otherwise FALSE. Remarks The ShowExploreT oolbar function only affects Windows Internet Explorers been opened already.
  • Page 44: Showtaskbar

    ShowTaskbar To SHOW or HIDE Taskbar function display. BOOL ShowTaskbar BOOL bShow Parameters bShow [in] Flag that indicates whether to SHOW(TRUE) or HIDE(FALSE) Taskbar display. Returned V alues Returning TRUE if the operation is successful; otherwise FALSE. Remarks After calling this function, the terminal will SHOW or HIDE Taskbar. If Taskbar is hidden by this function, it needs to call this function to display Taskbar again.
  • Page 45: Unregisteralphakeynotification

    UnRegisterAlphaKeyNotification To Unregister AlphaKey Notification function request so that the application will no longer receive Alpha Key been pressed notification messages. DWORD UnregisterAlphaKeyNotification HANDLE hWnd, Parameters hWnd [in] The handling window of the application. Returned V alues Returning 0 if the operation is successful, otherwise return 1. Example if(UnregisterAlphaKeyNotification(this->m_hWnd)) AfxMessageBox(_T("UnregisterAlphaKeyNotification FAIL!!"));...
  • Page 46: Registertriggerkeynotification

    RegisterTriggerKeyNotification To Register the application to SYSAPIAX.dll, so that SYSAPIAX.dll will send a window message to the application when the trigger Key is pressed or released DWORD RegisterTriggerKeyNotification HANDLE hWnd, UINT uMsg Parameters hWnd [in] The handling window of the application to receive the message. uMsg [in] The message value to be sent when trigger Key is pressed or released Returned V alues...
  • Page 47: Unregistertriggerkeynotification

    UnregisterTriggerKeyNotification To Unregister triggerkey Notification function request so that the application will no longer receive trigger key been pressed or released notification messages. DWORD UnregisterTriggerKeyNotification HANDLE hWnd Parameters hWnd [in] The handling window of the application. Returned V alues Returning 0 if the operation is successful, otherwise return 1. Example if(UnregisterTriggerKeyNotification(this->m_hWnd)) AfxMessageBox(_T("UnregisterTriggerKeyNotification FAIL!!"));...
  • Page 48: Vibrator Related Functions

    Vibrator Related Functions VibratorOn To turn ON or OFF the Vibration indicator DWORD VibratorOn BOOL Parameters [in] Flag that indicates whether to turn ON(TRUE) or OFF(FALSE) the vibration indicator. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
  • Page 49: Wlan Related Function

    WLAN Related Function WL_Enable To ENABLE the WLAN function. BOOL WL_Enable Parameters None. Returned V alues Returning TRUE if the operation is successful; otherwise FALSE. Example BOOL bResult; bResult = WL_Enable(); if(bResult == FALSE) AfxMessageBox(_T("Wireless enable fail")); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll...
  • Page 50: Wl_Disable

    WL_Disable To DISABLE the WLAN function. BOOL WL_Disable Parameters None. Returned V alues Returning TRUE if the operation is successful; otherwise FALSE. Example BOOL bResult; bResult = WL_Disable(); if(bResult == FALSE) AfxMessageBox(_T("Wireless disable fail")); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll...
  • Page 51: Bluetooth Related Function

    Bluetooth Related Function BT_On To ENABLE the Bluetooth function and power. BOOL BT_On Parameters None. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are BT_ERR_CREA TE_FAIL, BT_ERR_INUSING. Example BOOL bResult; bResult = BT_On();...
  • Page 52: Bt_Off

    BT_Off To DISABLE the Bluetooth function and power. void BT_Off Parameters None. Returned V alues None Example BT_Off(); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 53: Setdiscovermode

    SetDiscoverMode Enable or disable terminal discovered mode. DWORD SetDiscoverMode BOOL bEnable Parameters bEnable [in] Flag that indicates whether to enable (TRUE) or disable (FALSE) the terminal discovered mode Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned value is BT_ERR_SETTING_FAIL.
  • Page 54: Getdiscovermode

    GetDiscoverMode Get terminal current discovered status. BOOL GetDiscoverMode Parameters None Returned V alues Return TRUE if terminal can be discovered, otherwise return FALSE. Example if(GetDiscoverMode()) AfxMessageBox(_T("Discover mode is enable")); Else AfxMessageBox(_T(“Discover mode is disable”)); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll...
  • Page 55: Setsppservice

    SetSPPService Enable or disable Bluetooth serial port profile service. DWORD SetSPPService BOOL bEnable Parameters bEnable [in] Flag that indicates whether to enable (TRUE) or disable (FALSE) the serial port profile service mode Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are BT_ERR_SETTING_FAIL, BT_ERR_REG_DEV_FAIL, BT_ERR_SPP_COM_FAIL.
  • Page 56: Getsppservice

    GetSPPService Get terminal current serial port profile service status. BOOL GetSPPService Parameters None Returned V alues Return TRUE if SPP service is enable, otherwise return FALSE. Example if(GetSPPService()) AfxMessageBox(_T("SPP service is enable")); Else AfxMessageBox(_T(“SPP service is disable”)); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll...
  • Page 57: Setftpservice

    SetFTPService Enable or disable File Transfer Profile service. DWORD SetFTPService BOOL bEnable Parameters bEnable [in] Flag that indicates whether to enable (TRUE) or disable (FALSE) the File Transfer Profile service mode Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are BT_ERR_SETTING_FAIL.
  • Page 58: Getftpservice

    GetFTPService Get terminal current File Transfer Profiel service status. BOOL GetFTPService Parameters None Returned V alues Return TRUE if FTP service is enable, otherwise return FALSE. Example if(GetFTPService()) AfxMessageBox(_T("FTP service is enable")); Else AfxMessageBox(_T(“FTP service is disable”)); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll...
  • Page 59: Setftpwriteable

    SetFTPWriteable Enable or disable File Transfer Profile writable. DWORD SetFTPWriteable BOOL bWriteable Parameters bWriteable [in] Flag that indicates whether to enable (TRUE) or disable (FALSE) the File Transfer Profile writeable mode Returned V alues Return E_FUNC_SUCCEED if the operation is successful. Example if(SetFTPWriteable(TRUE) != E_FUNC_SUCCEED) AfxMessageBox(_T("Set FTP writeable fail"));...
  • Page 60: Getftpwriteable

    GetFTPWriteable Get terminal current File Transfer Profile writeable status. BOOL GetFTPWriteable Parameters None Returned V alues Return TRUE if FTP writeable is enable, otherwise return FALSE. Example if(GetFTPWriteable()) AfxMessageBox(_T("FTP service is writeable")); else AfxMessageBox(_T(“FTP service is diswriteable)); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll...
  • Page 61: Setftpsharefolder

    SetFTPShareFolder Setup the File Transfer Profile share folder. DWORD SetFTPShareFolder WCHAR *strShareFolder Parameters strShareFolder [in] The folder for File Transfer Profile. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned value is E_FUNC_PAR_ERROR.
  • Page 62: Getftpsharefolder

    GetFTPShareFolder Get terminal current File Transfer Profile share folder. DWORD GetFTPShareFolder WCHAR *strShareFolder, *nFolderLen Parameters strShareFolder [out] The buffer to receive the share folder string nFolderLen [in/out] The strShareFolder buffer max size. If terminal current share folder length > nFolderLen, the nFolderLen receive current share folder length.
  • Page 63: Initsearchbtdevice

    InitSearchBTDevice This function initiates search information. DWORD InitSearchBTDevice HANDLE *hLookup Parameters hLookup [out] Handle to be used when calling the FindNextBTDevice & EndSearchBTDevice function Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR., BT_ERR_DEVICE_ERROR.
  • Page 64: Findnextbtdevice

    FindNextBTDevice This function retrieves the results of an nearby Bluetooth device search. DWORD FindNextBTDevice HANDLE hLookup, LPTSTR szDeviceName, ULONGLONG *btAddress, nNameLen Parameters hLookup [in] Handle obtained from InitSearchBTDevice function szDeviceName [out] The buffer to receive the device name string btAddress [out] Receive the device address of 64-bit unsigned integer nNameLen [in] The szDeviceName buffer max size.
  • Page 65 dwRe = FindNextBTDevice(hLookup, szDeviceName, &btAddress, 256); if(dwRe == BT_ERR_DEVICE_ERROR) break; ………… wsprintf(szAddress, L"%04X%08X", GET_NAP(btAddress), GET_SAP(btAddress)); ………… EndSearchBTDevice(hLookup); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 66: Endsearchbtdevice

    EndSearchBTDevice This function frees the search handle. DWORD EndSearchBTDevice HANDLE hLookup Parameters hLookup [in] Handle obtained from InitSearchBTDevice function Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, BT_ERR_DEVICE_ERROR. Example DWORD dwRe;...
  • Page 67: Initsearchftpdevice

    InitSearchFTPDevice Initial search Bluetooth device support File Transfer Profile service. DWORD InitSearchFTPDevice Parameters None Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, BT_ERR_DEVICE_ERROR. Example DWORD dwPos, dwRe; WCHAR szDeviceName[128];...
  • Page 68: Findfirstftpdevice

    FindFirstFTPDevice Get the first searched device position information after calling InitSearchFTPDevice(). DWORD FindFirstFTPDevice DWORD *dwPos, LPTSTR szDeviceName, ULONGLONG *btAddress, nNameLen Parameters dwPos [in/out] a reference to a position value returned by FindFirstBTDevice or FindNextBTDevice function szDeviceName [out] The buffer to receive the device name string btAddress [out] Receive the device address of 64-bit unsigned integer nNameLen...
  • Page 69 wsprintf(szAddress, L"%04X%08X", GET_NAP(btAddress), GET_SAP(btAddress)); ………… Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 70: Findnextftpdevice

    FindNextFTPDevice Get the next searched device position information. DWORD FindNextFTPDevice DWORD *dwPos, LPTSTR szDeviceName, ULONGLONG *btAddress, nNameLen Parameters dwPos [in/out] a reference to a position value returned by FindFirstBTDevice or FindNextBTDevice function szDeviceName [out] The buffer to receive the device name string btAddress [out] Receive the device address of 64-bit unsigned integer nNameLen...
  • Page 71 wsprintf(szAddress, L"%04X%08X", GET_NAP(btAddress), GET_SAP(btAddress)); ………… Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 72: Pairdevice

    PairDevice Pair terminal with other device. DWORD PairDevice ULONGLONG btAddress unsigned char PinCode[16] Parameters btAddress [in] The device address for pair with PinCode [in] The pin code for connection Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are BT_ERR_PAIR_FAIL, BT_ERR_DEVICE_ERROR.
  • Page 73: Unpairdevice

    UnPairDevice Unpair terminal with other device. DWORD UnPairDevice ULONGLONG btAddress Parameters btAddress [in] The device address for unpair Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned value is BT_ERR_DEVICE_ERROR. Example PairDevice(btAddress, PinCode);...
  • Page 74: Getcominfo

    GetComInfo Get com identifier index and amount from device hardware. DWORD GetComInfo int *nComSum, LPCWSTR pComV alue, *nComV alueLen Parameters nComSum [out] Receive the device com amount pComV alue [out] The buffer to receive the device com identifier index nComV alueLen [in/out] The pComV alue buffer max size.
  • Page 75 Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 76: Connectdevice

    ConnectDevice Connect to Bluetooth device for SPP or FTP . DWORD ConnectDevice ULONGLONG btAddress, CONNECT_INFO *Info, BOOL nConnect Parameters btAddress [in] The device address for connect Info [in] The device connect information., see CONNECT_INFO data structure. nConnect [in] Connect status. 1  connect, 0  disconnect Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
  • Page 77: Getconnectstatus

    GetConnectStatus Query the device connect status. DWORD GetConnectStatus ULONGLONG btAddress, int nConnectType, LPCWSTR pCom, *nStatus Parameters btAddress [in] Bluetooth device address nConnectType [in] Connect profile type. 1 Serial port profile, 2  File transfer profile pCom [in] The connect com for Serial port profile, must be four characters long.. Contains "COM"+ com identifier index, for example "COM7".
  • Page 78: Getsppclientchannel

    GetSPPClientChannel Get the device serial port profile channel. DWORD GetSPPClientChannel ULONGLONG btAddress, *nChannel Parameters btAddress [in] The device address which to get SPP channel nChannel [out] Receive queried channel Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, BT_ERR_DEVICE_ERROR.
  • Page 79: Findfirstftpfile

    FindFirstFTPFile Get first file information from share folder in the connected device. DWORD FindFirstFTPFile WCHAR *path, FTP_FILE *File Parameters path [in] The path of connected device for search file. File [out] The first searched file information in the path, see FTP_FILE data structure.
  • Page 80: Findnextftpfile

    FindNextFTPFile Get next file information from share folder in the connected device. DWORD FindNextFTPFile FTP_FILE *File Parameters File [out] The received file information, see FTP_FILE data structure. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_PAR_ERROR, BT_ERR_DEVICE_NOT_CONNECT, BT_ERR_FTP_EMPTY_FILE.
  • Page 81: Getftpfile

    GetFTPFile Get file from share folder in the connected device. DWORD GetFTPFile LPCWSTR pTargetFile Parameters pT argetFile [in] The file to get from connected device Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, BT_ERR_DEVICE_NOT_CONNECT.
  • Page 82: Putftpfile

    PutFTPFile Send file to share folder in the connected device. DWORD PutFTPFile LPCWSTR pSourceFile, LPCWSTR pTargetPath Parameters pSourceFile [in] The source file in the share folder to transfer to connected device. pT argetPath [in] The target path in the connected device to save file. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
  • Page 83: Createftpfolder

    CreateFTPFolder Create a new folder to share folder in the connected device. DWORD CreateFTPFolder LPCWSTR pTarget Parameters pT arget [in] The folder which be created to share folder in the connected device Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, BT_ERR_DEVICE_NOT_CONNECT.
  • Page 84: Deleteftpfolder

    DeleteFTPFolder Delete folder from share folder in connected device. DWORD DeleteFTPFolder LPCWSTR pTarget Parameters pT arget [in] The folder will be deleted from share folder in the connected device Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, BT_ERR_DEVICE_NOT_CONNECT.
  • Page 85: Deleteftpfile

    DeleteFTPFile Delete file from share folder in connected device. DWORD DeleteFTPFile LPCWSTR pTarget Parameters pT arget [in] The file will be deleted from share folder in the connected device. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, BT_ERR_DEVICE_NOT_CONNECT.
  • Page 86: Camera Related Function

    Camera Related Function Camera_On To ENABLE the Camera function and initial. DWORD Camera_On HWND hVideoWnd Parameters hVideoWnd [in] The handle of new owner window. This parameter can set NULL. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are CAM_ERR_CREA TE_FAIL, CAM_ERR_VERSION_ERROR, CAM_ERR_GET_DEVICE_FAIL, CAM_ERR_VIDEO_WINDOW_FAIL, CAM_ERR_STILL_SETTING_FAIL.
  • Page 87: Camera_Off

    Camera_Off To DISABLE the Camera function and release. void Camera_Off Parameters None. Returned V alues None Example BT_Off(); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 88: Setpreviewsize

    SetPreviewSize To set the x-axis coordinate、y-axis coordinate、 width、height of the preview window. DWORD SetPreviewSize UINT uiPosX UINT uiPosY UINT uiWidth UINT uiHeight Parameters uiPosX [in] Specifies the x-axis coordinate to be set. Range: 0~240. uiPosY [in] Specifies the y-axis coordinate to be set. Range: 0~320. uiWidth [in] Specifies the width to be set.
  • Page 89: Getpreviewsize

    GetPreviewSize To get the x-axis coordinate、y-axis coordinate、width、height of the preview window. DWORD GetPreviewSize UINT *uiPosX UINT *uiPosY UINT *uiWidth UINT *uiHeight Parameters uiPosX [out] Specifies the x-axis coordinate to be retrieved. uiPosY [out] Specifies the y-axis coordinate to be retrieved. uiWidth [out] Specifies the width to be retrieved.
  • Page 90: Enablepreview

    EnablePreview Change to ENABLE or DISABLE of the preview window. DWORD EnablePreview BOOL bEnable Parameters bEnable [in] Flag that indicates whether to ENABLE(TRUE) or DISABLE(FALSE) preview window. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, CAM_ERR_DEVICE_ERROR.
  • Page 91: Setstillcapturesize

    SetStillCaptureSize To set the image pixel for still picture capture. DWORD SetStillCaptureSize DWORD dwImageSize Parameters dwImageSize [in] Flags for setting image pixel. This parameterer must be one of the values in the table below. Value Image pixel QSXGA (2560*1944) SXGA (1280*960) Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
  • Page 92: Getstillcapturesize

    GetStillCaptureSize To get the image pixel setting value for still picture capture. DWORD GetStillCaptureSize DWORD *dwImageSize Parameters dwImageSize [out] Receive the image pixel setting value. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, CAM_ERR_DEVICE_ERROR.
  • Page 93: Startstillcapture

    StartStillCapture To Start with still picture capture and save to file path. DWORD StartStillCapture LPTSTR lpPathName BOOL bSound Parameters lpPathName [in] Pointer to the file save path after capture still picture. Max size of 256. bSound [in] Flag that indicates whether to ENABLE(TRUE) or DISABLE(FALSE) shutter sound. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
  • Page 94: Setflash

    SetFlash To set ENABLE or DISABLE the flash light. DWORD SetFlash BOOL bEnable Parameters bEnable [in] Flag that indicates whether to ENABLE(TRUE) or DISABLE(FALSE) flash light. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
  • Page 95: Getflash

    GetFlash To get the flash light setting value. BOOL GetFlash Parameters None. Returned V alues Return TRUE if flash light is enable, otherwise return FALSE Example if(GetFlash () != TRUE) AfxMessageBox(_T("Flash is disable)); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll...
  • Page 96: Setdarkmode

    SetDarkMode To set ENABLE or DISABLE the dark mode DWORD SetDarkMode BOOL bEnable Parameters bEnable [in] Flag that indicates whether to ENABLE(TRUE) or DISABLE(FALSE) dark mode. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
  • Page 97: Getdarkmode

    GetDarkMode To get the dark mode setting value. BOOL GetDarkMode Parameters None. Returned V alues Return TRUE if dark mode is enable, otherwise return FALSE Example if(GetDarkMode() != TRUE) AfxMessageBox(_T("Dark mode is disable)); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll...
  • Page 98: Setinvert

    SetInvert To set the media stream invert, include flip、mirror. DWORD SetInvert BOOL bFlip BOOL bMirror Parameters bFlip [in] Flag that indicates whether to ENABLE(TRUE) or DISABLE(FALSE) media stream invert of upside down. bMirror [in] Flag that indicates whether to ENABLE(TRUE) or DISABLE(FALSE) media stream invert of left to right.
  • Page 99: Getinvert

    GetInvert To get the media stream invert setting value, include flip、mirror.. DWORD GetInvert BOOL *bFlip BOOL *bMirror Parameters bFlip [out] Receive the media stream flip setting value. bMirror [out] Receive the media stream mirror setting value. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR.
  • Page 100: Gprs R Ela Ted F Unction

    GPRS Related Function GPRS_On To ENABLE the GPRS function and initial. DWORD GPRS_On Parameters None Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are GPRS_ERR_CREA TE_FAIL, GPRS_ERR_VERSION_ERROR. Example if(GPRS_On(NULL) != E_FUNC_SUCCEED) AfxMessageBox(_T("GPRS on fail"));...
  • Page 101: Gprs_Off

    GPRS_Off To DISABLE the GPRS function and release. void GPRS_Off Parameters None. Returned V alues None Example GPRS_Off(); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 102: Getgprspowerstatus

    GetGPRSPowerStatus Get current power status of GPRS module. BOOL GetGPRSPowerStatus BOOL *bStatus Parameters bStatus [out] Flag that indicates whether to ENABLE(TRUE) or DISABLE(FALSE) GPRS power. Returned V alues Returning TRUE if the operation is successful; otherwise FALSE. Example BOOL bStatus; if(GetGPRSPowerStatus(&bStatus) != TRUE) AfxMessageBox(_T("Get GPRS power status fail!"));...
  • Page 103: Sendatcommand

    SendATCommand Send specify A T command and verify required response. DWORD SendATCommand char *lpCmd, char *lpResponse, DWORD dwResLen, DWORD dwWaitTime Parameters lpCmd [in] Specifies A T command. Max size of 256. lpResponse [out] Receive the required response data. dwResLen [in] The lpResponse buffer max size. dwW aitTime [in] The time interval for wait response, in milliseconds.
  • Page 104: Getatresponse

    GetATResponse Get response data from module buffer. DWORD GetATResponse char *lpResponse, DWORD dwResLen, DWORD dwWaitTime Parameters lpResponse [out] Receive the response data. dwResLen [in] The lpResponse buffer max size. dwW aitTime [in] The time interval for wait response, in milliseconds. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
  • Page 105: Getimeinumber

    GetIMEINumber Get module International Mobile Equipment Identity (IMEI) number. DWORD GetIMEINumber LPTSTR lpIMEI Parameters lpResponse [out] Receive the module IMEI number. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR.
  • Page 106: Getimsinumber

    GetIMSINumber Get SIM card International Mobile Subscriber Identity (IMSI) number. DWORD GetIMSINumber LPTSTR lpIMSI Parameters lpIMSI [out] Receive the SIM card IMSI number. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR.
  • Page 107: Getmoduleinfo

    GetModuleInfo Get module identification information, include manufacture、module、revision. DWORD GetATResponse LPTSTR lpManufacture, LPTSTR lpModule, LPTSTR lpRevision Parameters lpManufacture [out] Receive the manufacture identification. lpModule [out] Receive the product model identification. lpRevision [out] Receive the firmware version identification. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR.
  • Page 108: Getsignalquality

    GetSignalQuality Get signal strength from the module to the GSM/GPRS network. DWORD GetSignalQuality DWORD *dwQuality Parameters dwQuality [out] Receive the signal strength.of GSM/GPRS network. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR.
  • Page 109: Connectras

    ConnectRAS Establishes a RAS connection. Supports callback information. DWORD ConnectRAS LPTSTR lpEntryName, HWND hNotifyWnd Parameters lpEntryName [in] The entry name to use to establishes the connect. hNotifyWnd [in] Pointer to a window handles to receive RasDial event notifications (for WinCE is WM_RASDIALEVENT).
  • Page 110: Disconnectras

    DisconnectRAS Disconnect current RAS connection. DWORD DisconnectRAS Parameters None Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR. Example if(DisconnectRAS() != E_FUNC_SUCCEED) AfxMessageBox(_T("Disconnect RAS fail!")); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll...
  • Page 111: Getrasconnstatus

    GetRASConnStatus Get status from the RAS connection opened with ConnectRAS. DWORD GetRASConnStatus DWORD *dwStatus Parameters dwStatus [out] Receive the current status of the specified RAS connection. Value Connect Status Disconnection or failed connection Successfully established connection Other connect status Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
  • Page 112: Createrasentry

    CreateRASEntry Create a new RAS entry. DWORD CreateRASEvtry LPTSTR lpEntryName, RAS_ENTRY *Entry Parameters lpEntryName [in] The RAS entry name of an new entry to be create. Entry [in] The connect entry information, see RAS_ENTRY data structure. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, GPRS_ERR_ENTRY_ALREADY_EXIST, GPRS_ERR_ENTRY_NOT_EXIST.
  • Page 113: Deleterasentry

    DeleteRASEntry Delete a RAS entry. DWORD DeleteRASEntry LPTSTR lpEntryName Parameters lpEntryName [in] The RAS entry name of an existing entry to be deleted. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
  • Page 114: Changerasentryname

    ChangeRASEntryName Change the name of a RAS entry. DWORD ChangeRASEntryName LPTSTR lpOldEntry, LPTSTR lpNewEntry Parameters lpOldEntry [in] The old RAS entry name of an existing entry. lpNewEntry [in] The new RAS entry name of an not exist entry. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
  • Page 115: Changerasentryproperty

    ChangeRASEntryProperty Change the property of a RAS entry. DWORD ChangeRASEvtryProperty LPTSTR lpEntryName, RAS_ENTRY *Entry Parameters lpEntryName [in] The RAS entry name of an existing entry to be change. Entry [in] The connect entry information, see RAS_ENTRY data structure. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
  • Page 116: Getrasentryproperty

    GetRASEntryProperty Get the property of a RAS entry. DWORD GetRASEvtryProperty LPTSTR lpEntryName, RAS_ENTRY *Entry Parameters lpEntryName [in] The RAS entry name of an existing entry to be get information. Entry [out] Receive the connect entry information, see RAS_ENTRY data structure. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
  • Page 117: Getrasentrycount

    GetRASEntryCount Get entry count for RAS connection. DWORD GetRASEntryCount *nCount Parameters nCount [out] Receive the RAS entry count. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR. Example int iCount;...
  • Page 118: Menurasentries

    MenuRASEntries Menu all existing RAS entries, and get specified entry name. DWORD MenuRASEntries int nIndex, LPTSTR lpEntryName Parameters nIndex [in] The zero-based index of a RAS entry. lpEntryName [out] Receive the specified RAS entry name. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
  • Page 119: Getpincounter

    GetPINCounter Get count of attempts still available for entering the currently required password, for example the PIN、PUK… DWORD GetPINCounter *nCount Parameters nCount [out] Receive the number of attempts still available. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR.
  • Page 120: Getpinstatus

    GetPINStatus Get the current authentication code status of SIM card DWORD GetPINStatust DWORD *dwStatus Parameters dwStatus [out] Receive the authentication code status. The return value can be one of the values in the following table. Value Authentication Code Status "ERROR", SIM card maybe not exist "READY", PIN has already been entered "SIM PIN", wait SIM PIN enter "SIM PUK", wait SIM PUK enter...
  • Page 121: Setpinlock

    SetPINLock Set PIN code lock or unlock. DWORD SetPINLock LPTSTR lpPIN, BOOL bLock Parameters lpPIN [in] PIN code passwords, size of 4~8 character. bLock [in] Flag that indicates whether to lock (TRUE) or unlock(FALSE) the PIN code. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
  • Page 122 GetPINLockStatus Get the PIN code lock status of SIM card DWORD GetPINLockStatus BOOL *bStatus Parameters bStatus [out] Receive the PIN code lock status. TRUE indicates lock is active, FALSE indicates lock is inactive. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR.
  • Page 123 CheckPINCode Enter PIN code passwords, and check correctness. DWORD GheckPINCode LPTSTR lpPIN, BOOL *bMatch Parameters lpPIN [in] PIN code passwords, size of 4~8 character. bMatch [out] Receive the check result. TRUE indicates passwords is ok, FALSE indicates passwords is error. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
  • Page 124 CheckPUKCode Enter PUK code passwords, and check correctness. DWORD CheckPUKCode LPTSTR lpPUK, LPTSTR lpNewPIN, BOOL *bMatch Parameters lpPUK [in] PUK code passwords, size of 8 character. lpNewPIN [in] New PIN code passwords, size of 4~8 character. bMatch [out] Receive the check result. TRUE indicates passwords is ok, FALSE indicates passwords is error. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
  • Page 125 ChangePINCode Allows defining new PIN code password. DWORD ChangePINCode LPTSTR lpOldPIN, LPTSTR lpNewPIN Parameters lpOldPIN [in] Old PIN code passwords, size of 4~8 character. lpNewPIN [in] New PIN code passwords, size of 4~8 character. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, GPRS_ERR_DEVICE_ERROR.
  • Page 126 ReadPhonebook Read a phonebook entry in SIM card. DWORD ReadPhonebook int nIndex, LPTSTR lpNumber, LPTSTR lpName Parameters nIndex [in] The one-based index of a phonebook entry. lpNumber [out] Receive the phonebook entry number lpName [out] Receive the phonebook entry text. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
  • Page 127 WritePhonebook Write a phonebook entry in SIM card. DWORD WritePhonebook int nIndex, LPTSTR lpNumber, LPTSTR lpName, nNumType Parameters nIndex [in] The one-based index of a phonebook entry. If this parameter is 0, the phonebook entry wills automatic write empty location. lpNumber [in] Phonebook entry number lpName...
  • Page 128 DeletePhonebook Delete a phonebook entry in SIM card. DWORD DeletePhonebook nIndex Parameters nIndex [in] The one-based index of a phonebook entry. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, GPRS_ERR_DEVICE_ERROR.
  • Page 129 ReadMultiPhonebook Read multitude phonebook entries in SIM card. DWORD ReadMultiPhonebook int nStartIndex, int nEndIndex, DWORD *dwResLen, PHONEBOOK_INFO *Info, DWORD *dwInfoLen, *nCount Parameters within nStartInde [in] The first location number to start reading, one-based index. nEndIndex [in] The last location number to stop reading, one-based index. dwResLen [in/out] The response buffer max size.
  • Page 130 int iCount; DWORD dwRet, dwInfoLen, dwResLen=10000; PHONEBOOK_INFO PhonebookInfo={0}; LPPHONEBOOK_INFO lpPhonebookInfo=&PhonebookInfo; dwInfoLen = sizeof(PHONEBOOK_INFO); PhonebookInfo.dwSize = sizeof(PHONEBOOK_INFO); if(dwRet = ReadMultiPhonebook(1, 10, &dwResLen, lpPhonebookInfo, &dwInfoLen, &iCount)) if(dwRet == GPRS_ERR_BUFFER_INSUFFICIENT) lpPhoneInfo = new PHONEBOOK_INFO[dwInfoLen / sizeof(PHONEBOOK_INFO)]; lpPhonebookInfo->dwSize=sizeof(PHONEBOOK_INFO); dwRet = ReadMultiPhonebook(1, 10, &dwResLen, lpPhonebookInfo, &dwInfoLen, &iCount); if(dwRet != E_FUNC_SUCCEED) AfxMessageBox(_T("Read multitude phonebook fail!"));...
  • Page 131 GetPhonebookTotal Get amount of phonebook entry in SIM card, include used、total. DWORD GetPhonebookTotal int *nUsed, *nTotal Parameters nUsed [out] Receive the amount of used. nT otal [out] Receive the amount of allow maximum. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR.
  • Page 132 GetPhoneMaxLength Get maximum length of number field and text field by SIM card. DWORD GetPhoneMaxLength int *nNumberLen, *nNameLen Parameters nNumberLen [out] Receive the maximum length of phone number. nNameLen [out] Receive the maximum length of phone text. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED.
  • Page 133 SendSMS Send SMS message to specified phone number. DWORD SendSMS LPTSTR lpCenterNum, LPTSTR lpSendNum, LPTSTR lpData Parameters lpCenterNum [in] The phone number of short message service center (SMSC), max size of 30. If this parameter is NULL, will use storage SMSC in terminal to send. lpSendNum [in] The phone number of recipient, max size of 30.
  • Page 134 ReadSMS Read a SMS message in SIM card. DWORD ReadSMS int nIndex, int *nStatus, LPTSTR lpNumber, LPTSTR lpData, LPTSTR lpTimeStamp Parameters nIndex [in] The one-based index of a SMS message. nStatus [out] Receive the message status. The return value can be one of the values in the following table. Value Message Status "REC UNREAD", received unread message...
  • Page 135 Requirements OS V ersions: Windows CE 6.0 or beyond. Header: sysapiax.h Link Library: sysapiax.lib Link DLL: sysapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 136 DeleteSMS Delete a SMS message in SIM card. DWORD DeleteSMS nIndex Parameters nIndex [in] The one-based index of a SMS message. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, GPRS_ERR_DEVICE_ERROR.
  • Page 137 ReadMultiSMS Read multitude SMS messages in SIM card. DWORD ReadMultiSMS int nStatus, DWORD *dwResLen, SMS_INFO *Info, DWORD *dwInfoLen, *nCount Parameters nStatus [in] The message status can be one of the values in the following table. Value Message Status "REC UNREAD", received unread messages "REC READ", received read messages "STO UNSENT", stored unsent messages "STO SENT", stored sent messages...
  • Page 138 Example #define LPSMS_INFO SMS_INFO* ………… int iCount; DWORD dwRet, dwInfoLen, dwResLen=10000; SMS_INFO SMSInfo={0}; LPSMS_INFO lpSMSInfo=&SMSInfo; dwInfoLen = sizeof(SMS_INFO); SMSInfo.dwSize = sizeof(SMS_INFO); if(dwRet = ReadMultiSMS (4, &dwResLen, lpSMSInfo, &dwInfoLen, &iCount)) if(dwRet == GPRS_ERR_BUFFER_INSUFFICIENT) lpSMSInfo = new SMS_INFO[dwInfoLen / sizeof(SMS _INFO)]; lpSMSInfo->dwSize=sizeof(SMS_INFO); dwRet = ReadMultiSMS (4, &dwResLen, lpSMSInfo, &dwInfoLen, &iCount);...
  • Page 139 WriteStorageSMS Write a SMS message to SIM memory storage. DWORD WriteStorageSMS int *nIndex, LPTSTR lpCenterNum, LPTSTR lpSendNum, LPTSTR lpData Parameters nIndex [out] Receive the one-based index of storage SMS message. lpCenterNum [in] The phone number of short message service center (SMSC) , max size of 30. If this parameter is NULL, will use storage SMSC in terminal to send.
  • Page 140 SendStorageSMS Send a SMS message from SIM memory storage. DWORD SendStorageSMS nIndex Parameters nIndex [in] The one-based index of storage SMS message. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, GPRS_ERR_DEVICE_ERROR.
  • Page 141 GetSMSTotal Get amount of SMS message in SIM card, include used、total. DWORD GetSMSTotal int *nUsed, *nTotal Parameters nUsed [out] Receive the amount of used. nT otal [out] Receive the amount of allow maximum. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR.
  • Page 142 SetSMSCentre Set phone number of short message service center (SMSC). DWORD SetSMSCentre LPTSTR lpNumber Parameters lpNumber [in] SMS centre phone number. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, GPRS_ERR_DEVICE_ERROR.
  • Page 143 GetSMSCentre Get phone number of short message service center (SMSC). DWORD GetSMSCentre LPTSTR lpNumber, nMaxLen Parameters lpNumber [out] Receive the SMS centre phone number. nMaxLen [in] The lpNumber buffer max size. Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR.
  • Page 144 SMS_Register To register the SMS application to SYSAPIAX.dll so that SYSAPIAX.dll can communicate with the application. DWORD SMS_Register HWND hNotifyWnd, UINT uNewSMSNotify, UINT uNewPhoneNotify Parameters hNotifyWnd [in] The window handling the function library will send message to report. uNewSMSNotify [in] Application-defined message identifier. The system uses this for notification message that it sends to the window identified in hNotifyWnd.
  • Page 145 SMS_UnRegister To unregister the SMS application from SYSAPIAX.dll. DWORD SMS_UnRegister Parameters None Returned V alues If the action succeeds, the returned value is E_FUNC_SUCCEED. If the action fails, possible returned values are E_FUNC_ERROR, GPRS_ERR_DEVICE_ERROR. Example if(SMS_UnRegister() != E_FUNC_SUCCEED) AfxMessageBox(_T("SMS_UnRegister fail!")); Requirements OS V ersions: Windows CE 6.0 or beyond.
  • Page 146 The GPS receiver on the PT90 uses COM8 to output NMEA messages, when the COM port is opened. Using Microsoft Standard API to open serial port and receive NMEA data. For details, please refer to NMEA 0183 ver3.0. Serial Configuration GPS receiver Com port Baud rate...
  • Page 147 Bluetooth Structure CONNECT_INFO Structure This setting file contains information used by ConnectDevice Struct CONNECT_INFO int nChannel; int nConnectType; WCHAR strCom[6]; Members nChannel The connect channel for Serial port profile nCannectType Connect profile type. 1 Serial port profile, 2  File transfer profile strCom The connect com for Serial port profile, must be four characters long..
  • Page 148 FTP_FILE Structure This setting file contains information used by FindFirstFTPFile, FindNextFTPFile Struct FTP_FILE int nFileType; WCHAR strPath[260]; WCHAR strFile[260]; DWORD dwFileSize; Members nFileType File object profile type. 0 File, 1 Folder strPath The file path strFile The file name; It will be null if the object is a folder dwFileSize The file size , in bytes;...
  • Page 149 GPRS Structure RAS_ENTRY Structure This setting file contains information used by CreateRASEntry, ChangeRASEntryProperty, GetRASEntryProperty. Struct CONNECT_INFO DWORD dwCountryCode; WCHAR szAreaCode[10]; WCHAR szPhoneNumber[128]; WCHAR szExtraCmd[330]; WCHAR szUserName[256]; WCHAR szPassword[256]; WCHAR szDomain[15]; Members dwCountryCode Specifies the country/region code portion of the phone number. szAreaCode Null.-terminated string that contains the area code.
  • Page 150 Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 151 PHONEBOOK_INFO Structure This setting file contains information used by ReadMultiPhonebook. Struct PHONEBOOK_INFO DWORD dwSize; int nIndex; WCHAR szNumber[30]; WCHAR szName[30]; Members dwSize Specifies the structure size, in bytes. nIndex The one-based index of a phonebook entry. szNumber Phonebook entry number. szName Phonebook entry text.
  • Page 152 SMS_INFO Structure This setting file contains information used by ReadMultiSMS. Struct SMS_INFO DWORD dwSize; int nIndex; int nStatus; WCHAR szNumber[30]; WCHAR szData[160]; WCHAR szTimeStamp[30]; Members dwSize Specifies the structure size, in bytes. nIndex The one-based index of a SMS message. nStatus Message status.
  • Page 153: Rfid.dll

    RFID.DLL We supply RFID.DLL which includes several functions to allow programmer to control the on-board RFID device. Programmer can use WINCE develop tool like Visual Studio 2005 to develop application programs. Descriptions of all these functions are given below. RFID Related Functions ...
  • Page 154 When user wants to use this library, user should link RFID.DLL, RFID.LIB and the relate functions header file (RFID.H). PT-90 Mobile Computer SDK Programming Manual...
  • Page 155: Rfid R Ela Ted F Unction

    RFID Related Function OpenComPort Open com port to connect the RFID module. int OpenComPort iCom Parameters iCom [in] The RFID module com port number. PT90 only specified com 6. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure. Example if(OpenComPort(6) != 0) AfxMessageBox(_T("RFID open com fail"));...
  • Page 156: Closecomport

    CloseComPort Close com port and disconnect the RFID module connection. int CloseComPort Parameters None. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure. Example if(CloseComPort() != 0) AfxMessageBox(_T("RFID close com fail")); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: RFID.h Link Library: RFID.lib Link DLL: RFID.dll...
  • Page 157: Getfwv Ersion

    GetFWVersion Get RFID module firmware version. int GetFWV ersion char lpOutV ersion[] Parameters lpOutV ersion [out] Receive the RFID module firmware version. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure. Example char cV ersion[20]; if(GetFWV ersion(cV ersion) != 0) AfxMessageBox(_T("Get FW version fail"));...
  • Page 158: Apiv Ersion

    APIVersion Get RFID API version. int APIV ersion char lpOutV ersion[] Parameters lpOutV ersion [out] Receive the RFID API version. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure. Example char cV ersion[20]; if(APIV ersion(cV ersion) != 0) AfxMessageBox(_T("Get API version fail"));...
  • Page 159: Setw Orkingtype

    SetWorkingType Set RFID module working type with different tag type, and this function should be called before read card. int SetWorkingType int iType, iHalfPower Parameters iType [in] The RFID module working type. This parameter must be one of the values in the table below. Value Working type 15693...
  • Page 160: Antennacontro

    AntennaContro Enable/Disable antenna to save power. int AntennaContro iSelect Parameters iSelect [in] Flag that indicates whether to Enable(1) or Disable(0) the antenna. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure. Example if(AntennaContro(1) != 0) AfxMessageBox(_T("Antenna control fail")); Requirements OS V ersions: Windows CE 6.0 or beyond.
  • Page 161: Inventory15693

    Inventory15693 Get ISO 15693 tag unique identifier (UID). int Inventory15693 char lpFlag[], char lpAFI[], char lpOutUID[] Parameters lpFlag [in] Set request flag, please refer to table below. This parameter displayed in base hexadecimal notation. Bit 8 Bit 7 Bit 6 Bit 5 Bit 4 Bit 3...
  • Page 162: Readsingleblock

    ReadSingleBlock Read data of single block from ISO 15693 tag. int ReadSingleBlock int iBlock, char lpFlag[], char lpAddressUID[], char lpOutData[] Parameters iBlock [in] The block index of ISO 15693 tag. Please refer to tag respective document. lpFlag [in] Set request flag, please refer to table belowand RFID Request Flags.
  • Page 163: Writesingleblock

    WriteSingleBlock Write data of single block to ISO 15693 tag. int WriteSingleBlock int iBlock, char lpFlag[], char lpAddressUID[], char lpData[] Parameters iBlock [in] The block index of ISO 15693 tag. Please refer to tag respective document. lpFlag [in] Set request flag, please refer to table below and RFID Request Flags.
  • Page 164: Writeafi

    WriteAFI Write application family identifier (AFI) to ISO 15693 tag. int WriteAFI char lpFlag[], char lpAddressUID[], char lpData[] Parameters lpFlag [in] Set request flag, please refer to table below and RFID Request Flags. This parameter displayed in base hexadecimal notation. Bit 8 Bit 7 Bit 6...
  • Page 165: Writedsfid

    WriteDSFID Write data structure format identifier (DSFID) to ISO 15693 tag. int WriteDSFID char lpFlag[], char lpAddressUID[], char lpData[] Parameters lpFlag [in] Set request flag, please refer to table below and RFID Request Flags. This parameter displayed in base hexadecimal notation. Bit 8 Bit 7 Bit 6...
  • Page 166: Lockafi

    LockAFI Lock application family identifier (AFI) on ISO 15693 tag. int LockAFI char lpFlag[], char lpAddressUID[], Parameters lpFlag [in] Set request flag, please refer to table below and RFID Request Flags. This parameter displayed in base hexadecimal notation. Bit 8 Bit 7 Bit 6 Bit 5...
  • Page 167: Lockdsfid

    LockDSFID Lock data structure format identifier (DSFID) on ISO 15693 tag. int LockDSFID char lpFlag[], char lpAddressUID[], Parameters lpFlag [in] Set request flag, please refer to table below and RFID Request Flags. This parameter displayed in base hexadecimal notation. Bit 8 Bit 7 Bit 6 Bit 5...
  • Page 168: Lockblock

    LockBlock Lock specific block on ISO 15693 tag. int LockBlock int iBlock, char lpFlag[], char lpAddressUID[], Parameters iBlock [in] The block index of ISO 15693 tag. Please refer to tag respective document. lpFlag [in] Set request flag, please refer to table below and RFID Request Flags.
  • Page 169: Tagsysteminfo

    TagSystemInfo Get tag information from ISO 15693 tag. int TagSystemInfo char lpFlag[], char lpAddressUID[], char lpOutData[] Parameters lpFlag [in] Set request flag, please refer to table belowand RFID Request Flags. This parameter displayed in base hexadecimal notation. Bit 8 Bit 7 Bit 6 Bit 5 Bit 4...
  • Page 170: Tagstayquiet

    TagStayQuiet Set ISO 15693 tag to stay quiet state. int TagStayQuiet char lpFlag[], char lpAddressUID[], Parameters lpFlag [in] Set request flag, please refer to table belowand RFID Request Flags. This parameter displayed in base hexadecimal notation. Bit 8 Bit 7 Bit 6 Bit 5 Bit 4...
  • Page 171: Tagselect

    TagSelect Set ISO 15693 tag to select state. int TagSelect char lpFlag[], char lpAddressUID[], Parameters lpFlag [in] Set request flag, please refer to table belowand RFID Request Flags. This parameter displayed in base hexadecimal notation. Bit 8 Bit 7 Bit 6 Bit 5 Bit 4 Bit 3...
  • Page 172: Tagresett Oready

    TagResetToReady Set select or ouiet tag to ready state. int TagResetToReady char lpFlag[], char lpAddressUID[], Parameters lpFlag [in] Set request flag, please refer to table belowand RFID Request Flags. This parameter displayed in base hexadecimal notation. Bit 8 Bit 7 Bit 6 Bit 5 Bit 4...
  • Page 173: Opencard14443A

    OpenCard14443A Open ISO 14443A tag of mifare type and get the tag UID. int OpenCard14443A char lpOutUID[], char lpOutType[] Parameters lpOutUID [out] Receive the tag unique identifier. lpOutData [out] Receive the tag type. Please refer to mifare based document For example common values in the following table.
  • Page 174: Readmifareblock

    ReadMifareBlock Read data of single block from ISO 14443A mifare S50/S70 tag. int ReadMifareBlock int iKeyType, char lpKey[], int iBlock, char lpOutData[] Parameters iKeyType [in] The key type. This parameter must be one of the values in the table below. Value Key type Key A...
  • Page 175: Writemifareblock

    WriteMifareBlock Write data of single block to ISO 14443A mifare S50/S70 tag. int WriteMifareBlock int iKeyType, char lpKey[], int iBlock, char lpData[] Parameters iKeyType [in] The key type. This parameter must be one of the values in the table below. Value Key type Key A...
  • Page 176: Readultralightblock

    ReadUltraLightBlock Read data of single block from ISO 14443A mifare ultralight tag. int ReadUltraLightBlock int iBlock, char lpOutData[] Parameters iBlock [in] The block index of mifare ultralight tag. Please refer to tag respective document. lpOutData [out] Receive the block data. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure.
  • Page 177: Writeultralightblock

    WriteUltraLightBlock Write data of single block to ISO 14443A mifare ultralight tag. int WriteUltraLightBlock int iBlock, char lpData[] Parameters iBlock [in] The block index of mifare ultralight tag. Please refer to tag respective document. lpData [in] The block data, 8byte. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure.
  • Page 178: Getuid14443B

    GetUid14443B Get ISO 14443B tag UID. int GetUid14443B int iType, char lpOutUID[] Parameters iType [in] The tag type. This parameter must be one of the values in the table below. Value Key type 14443B SR176 SRIX4K lpOutUID [out] Receive the tag unique identifier. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure.
  • Page 179: Srix4Kchipid

    SRIX4KChipID Get ISO 14443B SRIX4K tag chip ID. int SRIX4KChipID char lpOutID[] Parameters lpOutData [out] Receive the tag chip ID. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure. Example char cID[4]; if(SRIX4KChipID(cID) != 0) AfxMessageBox(_T("Get SRIX4K chip ID fail")); Requirements OS V ersions: Windows CE 6.0 or beyond.
  • Page 180: Srix4Kreadblock

    SRIX4KReadBlock Read data of single block from ISO 14443B SRIX4K tag. int SRIX4KReadBlock int iBlock, char lpOutData[] Parameters iBlock [in] The block index of SRIX4K tag. Please refer to tag respective document. lpOutData [out] Receive the block data. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure.
  • Page 181: Srix4Kwriteblock

    SRIX4KWriteBlock Write data of single block to ISO 14443B SRIX4K tag. int SRIX4KWriteBlock int iBlock, char lpData[] Parameters iBlock [in] The block index of SRIX4K tag. Please refer to tag respective document. lpOutData [in] The block data, 8byte. Returned V alues Returning zero if the operation is successful, otherwise, indicates failure.
  • Page 182: Rfid R Equest F Lags

    RFID Request Flags Flag Name Value Description Request executed by any tag according to the setting of Address flag. Bit 5 Select_flag Request executed only by tag in selected state. The Address flag is set to 0 and the UID field is not included in the request. Request is not addressed.
  • Page 183: Srix4K Flow Chart

    SRIX4K Flow Chart RFID module on SetWorkingType(3,0) SRIX4KChipID() GetUid14443B() SRIX4KReadBlock() SRIX4KWriteBlock() Remove tag of RFID field PT-90 Mobile Computer SDK Programming Manual...
  • Page 184: Scanapiax.dll

    SCANAPIAX.DLL We supply SCANAPIAX.DLL to allow programmer to control the on-board scanning device. There are several functions available for programmer to tailor the application. Programmer can also use Windows CE development tool, such as Visual Studio 2005, to develop application program and control the on-board scanning device.
  • Page 185  SCAN_BatchSetting – Setup scanner in batch command.  SCAN_BatchRead – Read scanner settings in batch command. Scan2Key Related Functions Programmer can use Scan2Key related functions to control scan.exe program. When scan.exe is loaded, scanned data will be sent to key buffer. Target application program can retrieve scanned data just like standard keyboard input.
  • Page 186  EAN8_Setting Structure – Information of EAN8 settings.  EAN13_Setting Structure – Information of EAN13 settings.  Industrial25_Setting Structure – Information of Industrial 2 of 5 settings.  Interleaved25_Setting Structure –Information of Interleaved 2 of 5 settings.  MSI_Setting Structure –...
  • Page 187: Api_Scan R Ela Ted F Unctions

    API_SCAN Related Functions API_Register To Register the target application to SCANAPIAX.dll so that SCANAPIAX.dll can communicate with the application. It will also set the scanning device to working mode. BOOL API_Register HWND hwnd Parameters hwnd [in] the window handling the function library will send message to report all activities of the scanning device.
  • Page 188: Api_Unregister

    API_Unregister To Unregister the target application from SCANAPIAX.dll and close the scanning device. void API_Unregister Parameters None Return V alues None. Example API_Unregister(); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: scanapiax.h Link Library: scanapiax.lib Link DLL: scanapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 189: Api_Getbardata

    API_GetBarData To Get Barcode into the buffer. When receiving the message SM_DA TA_READY , call this function can get the barcode data. UINT API_GetBarData LPBYTE buffer, UINT * uiLength, UINT * uiBarType Parameters buffer [out] buffer for scanned data string. uiLength [in/out] buffer size uiBarType...
  • Page 190 strBarType.Format(_T("%d"), uiType); for(i = 0 ; i < strlen(pBuf); i++) strBarData += *(pBuf+i); AfxMessageBox( _T("Type:") + strBarType + _T("\r\nBarcode:") + strBarData); return 0; Requirements OS V ersions: Windows CE 6.0 or beyond. Header: scanapiax.h Link Library: scanapiax.lib Link DLL: scanapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 191: Api_Getbardatalength

    API_GetBarDataLength To Get Length of the scanned data UINT API_GetBarDataLength Parameters None Returned V alues Length of the scanned data Example if(message == SM_DA TA_READY){ CString strData; UINT uiSize, uiType, i,uiLength; char *pBuf; uiLength = API_GetBarDataLength(); if(uiLength == 0) strData = _T("No Data"); else{ uiSize = uiLength+1;...
  • Page 192: Api_Getbartype

    API_GetBarType To Get the barcode type. UINT API_GetBarType Parameters None Returned V alues Always return zero Remarks value Barcode value Barcode BC_CODE11(100) Code 11 BC_UK_PLESSEY(111) UK Plessey BC_CODE39(101) Code 39 BC_TELEPEN(112) Telepen BC_CODE93(102) Code 93 BC_UPCA(113) UPCA BC_CODE128(103) Code 128 BC_UPCE(114) UPCE BC_CODABAR(104)
  • Page 193: Api_Geterror

    API_GetError To Get the error code. DWORD API_GetError Parameters None Returned V alues The returned value can be one of those in the table below: Constant Value Description ERR_WRITE_FAIL WM_USER+1 Send commands to scanner module failed. ERR_SETTING_FAIL WM_USER+2 Set scanner setting failed. ERR_SCANNER_NOT_OPEN WM_USER+3 Open scanner module failed.
  • Page 194: Api_Getsyserror

    API_GetSysError To Get the system error code. DWORD API_GetSysError Parameters None Returned V alues Returning the system error code that is returned by GetLastError(). Descriptions of system error code can be found in MSDN. Example dwError = API_GetSysError(); strMess.Format(_T("System Error Code: %d"), dwError); AfxMessageBox(strMess);...
  • Page 195: Api_Goodread

    API_GoodRead To activate a buzzer sound when the buzzer of the scanning device is enabled and to flash the LED when the good-read LED of the scanning device is enabled. void API_GoodRead Parameters None Returned V alues None. Remarks Use API_GoodRead() to notify the user that a barcode data is successfully scanned. The buzzer function of the scanning device can be set by Scan Configuration in the control panel.
  • Page 196: Api_Loadsettingsfromfile

    API_LoadSettingsFromFile To Load scanner settings from file. BOOL API_LoadSettingsFromFile LPCTSTR filename Parameters filename [in] the scanner setting file(*.axs) Returned V alues Returning TRUE if the operation is successful, otherwise, return FALSE. Example CString strFile; CFileDialog dlg(TRUE, NULL, NULL, OFN_FILEMUSTEXIST | OFN_PA THMUSTEXIST); if(dlg.DoModal() != IDOK) return;...
  • Page 197: Api_Reset

    API_Reset To Reset the scanner settings to default. BOOL API_Reset Parameters None Returned V alues Returning TRUE if the operation is successful, otherwise, return FALSE. Example if(API_Reset()) AfxMessageBox(_T("Reset Succeed")); else AfxMessageBox(_T("Reset Fail")); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: scanapiax.h Link Library: scanapiax.lib Link DLL: scanapiax.dll...
  • Page 198: Api_Resetbardata

    API_ResetBarData To Clear the data buffer to allow the next scanned data coming in. void API_ResetBarData Parameters None ReturnedV alues None. Example API_ResetBarData(); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: scanapiax.h Link Library: scanapiax.lib Link DLL: scanapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 199: Api_Savesettingst Ofile

    API_SaveSettingsToFile To Save current scanner settings to file. The extension file name is “axs”. BOOL API_SaveSettingsToFile LPCTSTR filename Parameters filename [in] file name of the scanner settings. Returned V alues Returning TRUE if the operation is successful, otherwise, return FALSE. Example CString strFile;...
  • Page 200: Api_Savesettingst Oscanner

    API_SaveSettingsToScanner To Write current scanner settings into the scanner. BOOL API_SaveSettingsToScanner Parameters None Returned V alues Returning TRUE if the operation is successful, otherwise, return FALSE. Example if(API_SaveSettingsToScanner()) AfxMessageBox(_T("Save to Scanner Succeed")); else AfxMessageBox(_T("Save to Scannere Fail")); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: scanapiax.h Link Library: scanapiax.lib Link DLL: scanapiax.dll...
  • Page 201: S2K_Isload

    S2K_IsLoad To Check if the application program scan.exe(scan barcode and send the scanned data into key buffer) is executing. BOOL S2K_IsLoad Parameters None Returned V alues The returned value TRUE indicates that scan.exe is running. The returned value FALSE indicates that scan.exe is not running.
  • Page 202: S2K_Load

    S2K_Load To Load or Unload the the application program scan.exe. BOOL S2K_Load BOOL bLoad, DWORD dwTimeOut Parameters bLoad [in] To set TRUE to Load scan.exe and FALSE to Unload scan.exe dwTimeOut [in] When Unload scan.exe it will wait until the scan.exe been closed or Timeout by this parameter. Returned V alues Returning TRUE if the operation is successful, otherwise, return FALSE.
  • Page 203: Scan_Querystatus

    SCAN_QueryStatus To Query current scanner settings. BOOL SCAN_QueryStatus int nCommand1, int nCommand2, char *pReturn Parameters nCommand1 [in] See scan command table. nCommand2 [in] See scan command table. pReturn [out] the current scanner settings. This buffer size must be larger than 100. ReturnedV alues Returning TRUE if the operation is successful, otherwise, return FALSE.
  • Page 204: Scan_Sendcommand

    SCAN_SendCommand To Send scanner command to change the scanner status. BOOL SCAN_SendCommand int nCommand1, int nCommand2, char *pV alue Parameters nCommand1 [in] See scan command table. nCommand2 [in] See scan command table. pV alue [in] See scan command table. Returned V alues Returning TRUE if the operation is successful, otherwise, return FALSE.
  • Page 205: Scan_Resumesystem

    SCAN_ResumeSystem To Enable/Disable scan key to resume system DWORD SCAN_ResumeSystem BOOL Parameters [in] Flag that indicates whether to Enable(TRUE) scan key to resume system or Disable(FALSE) scan key to resume system. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, E_FUNC_SCANNER_NOT_OPEN.
  • Page 206: Scan_Batchsetting

    SCAN_BatchSetting To Setup all scanner settings in batch command DWORD SCAN_BatchSetting ScannerSetting setting Parameters setting [in] The ScannerSetting data structure. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED.. If this action fails, possible returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR, E_FUNC_SCANNER_NOT_OPEN, E_FUNC_SETTING_FAIL.
  • Page 207: Scan_Batchread

    SCAN_BatchRead To Read all scanner settings in batch command DWORD SCAN_BatcRead ScannerSetting *setting Parameters setting [out] Pointer to ScannerSetting data structure. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, possible returned values are E_FUNC_SCANNER_NOT_OPEN, E_FUNC_PAR_ERROR.
  • Page 208: Pt_Openscan2Key

    Scan2Key Related Functions PT_OpenScan2Key To Execute scan.exe to scan barcode and send the scanned data into terminal key buffer. BOOL PT_OpenScan2Key Parameters None Returned V alues Returning TRUE if the operation is successful, otherwise, return FALSE. Example BOOL bResult; bResult = PT_OpenScan2Key(); if(!bResult) AfxMessageBox(_T("PT_OpenScan2Key fail"));...
  • Page 209: Pt_Closescan2Key

    PT_CloseScan2Key To Close application program scan.exe. void PT_CloseScan2Key Parameters None Returned V alues None. Example PT_CloseScan2Key() Requirements OS V ersions: Windows CE 6.0 or beyond. Header: scanapiax.h Link Library: scanapiax.lib Link DLL: scanapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 210: Pt_Sett Odefault

    PT_SetToDefault To Reset all the scanner settings to default value. int PT_SetToDefault Parameters None Returned V alues Returning 1 if the operation is successful, otherwise, return 0. Example if(!PT_SetToDefault()) AfxMessageBox(_T("PT_SetToDefault fail")); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: scanapiax.h Link Library: scanapiax.lib Link DLL: scanapiax.dll...
  • Page 211: S Canner R Ela Ted F Unctions

    Scanner Related Functions PT_EnableScanner To Enable scanner to scan barcode. This function will also get scanned data from scanning device and store in the system buffer. Application can use the other function, PT_GetBarcodeData , to retrieve scanned data from system buffer. int PT_EnableScanner Parameters None...
  • Page 212: Pt_Disablescanner

    PT_DisableScanner To close the scanning device. void PT_DisableScanner Parameters None Returned V alues None. Example PT_DisableScanner(); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: scanapiax.h Link Library: scanapiax.lib Link DLL: scanapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 213: Pt_Checkbarcodedata

    PT_CheckBarcodeData To Check whether there is scanned barcode data available in system buffer. BOOL PT_CheckBarcodeData Parameters None Returned V alues This function returns TRUE if there is scanned barcode data in system buffer and FALSE if there is no scanned barcode data in system buffer.
  • Page 214: Pt_Getbarcodedata

    PT_GetBarcodeData To Get Barcode data and barcode type from system buffer. BOOL PT_GetBarcodeData UINT * uiBarType, Char * pBuffer, UINT * uiMaxBufferLen Parameters uiBarType [out] barcode type. pBuffer [out] buffer for storing scanned data.. uiMaxBufferLen [in/out] The maximum buffer size Returned V alues Returning TRUE if the operation is successful, otherwise, return FALSE.
  • Page 215 Header: scanapiax.h Link Library: scanapiax.lib Link DLL: scanapiax.dll Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 216: Pt_Setdefault

    PT_SetDefault To Reset the scanner settings to default. BOOL PT_SetDefault Parameters None Returned V alues Returning TRUE if the operation is successful, otherwise, return FALSE. Example if(PT_SetDefault()) AfxMessageBox(_T("PT_SetDefault succeed")); else AfxMessageBox(_T("PT_SetDefault fail")); Requirements OS V ersions: Windows CE 6.0 or beyond. Header: scanapiax.h Link Library: scanapiax.lib Link DLL: scanapiax.dll...
  • Page 217: Enabletriggerkey

    Scan Key Related Functions EnableTriggerKey To Enable or Disable the scan Trigger Key. DWORD EnableTriggerKey BOOL bEnable Parameters bEnable [in] Flag that indicates whether to Enable(TRUE) or Disable(FALSE) the scan Trigger Key. Returned V alues If this action succeeds, the returned value is E_FUNC_SUCCEED. If this action fails, the returned values are E_FUNC_ERROR, E_FUNC_PAR_ERROR.
  • Page 218: Getlibraryv Ersion

    GetLibraryVersion To Get Library V ersion information. int GetLibraryV ersion Parameters None Returned V alues The version information, for example, if the returned value is 301, it means that dll version is 3.01 Example int nV ersion; CString strTemp; nV ersion = GetLibraryV ersion(); strTemp.Format(_T("V ersion = %d"), nV ersion);...
  • Page 219: Gettriggerkeystatus

    GetTriggerKeyStatus To Get scan Trigger Key Status. DWORD GetTriggerKeyStatus Parameters None. Returned V alues Returned value 1 indicates that the scan Trigger Key is enabled. Returned value 0 indicates that the scan Trigger Key is disabled. Example if(GetTriggerKeyStatus()) AfxMessageBox(_T("scan key ensable!")); else AfxMessageBox(_T("scan key disable!"));...
  • Page 220: Presstriggerkey

    PressTriggerKey ToTrigger the Scan Key. DWORD PressTriggerKey BOOL bPress Parameters bPress [in] Flag that indicates whether to Press(TRUE) or Release(FALSE) the scan Trigger Key. Returned V alues If this action succeeds, the returnedvalue is E_FUNC_SUCCEED. If this action fails, the returned value is E_FUNC_ERROR.
  • Page 221: Triggerstatus

    TriggerStatus To get the scan Trigger Key status. DWORD TriggerStatus Parameters None. Returned V alues The returned value 1 indicates that the scan Trigger Key is pressed and 0 indicates that scan Trigger Key is released. Example if(TriggerStatus()) AfxMessageBox(_T("scan key pressed!")); else AfxMessageBox(_T("scan key release!"));...
  • Page 222: S Can S Tructure

    Scan Structure ScannerSetting Structure This setting file contains information used by SCAN_BatchSetting and SCAN_BatchRead.. Struct ScannerSetting DWORD cbSize; struct GeneralSetting generalsetting; struct Code11_Setting Code11; struct Code39_Setting Code39; struct Code93_Setting Code93; struct Code128_Setting Code128; struct Codabar_Setting Codabar; struct EAN8_Setting EAN8; struct EAN13_Setting EAN13; struct Industrial25_Setting Indust25;...
  • Page 223 Code39 Code39_Setting Structure. Code93 Code93_Setting Structure. Code128 Code128_Setting Structure. Codabar Codabar_Setting Structure. EAN8 EAN8_Setting Structure. EAN13 EAN13_Setting Structure. Indust25 Industrial25_Setting Structure. Inter25 Interleaved25_Setting Structure. MSIPlessey MSI_Setting Structure. UKPlessey UK_Setting Structure. Telepen Telepen_Setting Structure. UPCA UPCA_Setting Structure. UPCE UPCE_Setting Structure. Matrix25 Matrix25_Setting Structure.
  • Page 224 Remarks The cbSize must be the size of Structure ScannerSetting, in bytes. Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 225: Generalsetting Structure

    GeneralSetting Structure This setting file contains information used by Structure ScannerSetting. Struct GeneralSetting UINT m_uiLED; UINT m_uiBeep; UINT m_uiVibrator; UINT m_uiScanResume; UINT m_uiPosition; UINT m_uiAimID; UINT m_uiGlobalMin; UINT m_uiGlobalLock; UINT m_ui1Type; UINT m_ui1Length; UINT m_ui2Type; UINT m_ui2Length; UINT m_ui3Type; UINT m_ui3Length; UINT m_ui4Type;...
  • Page 226: Code11_Setting Structure

    Code11_Setting Structure This setting contains information used by Structure ScannerSetting. Struct Code11_Setting UINT m_uiRead; UINT m_uiChkDig; UINT m_uiXmitChkDig; UINT m_uiCodeID; Members All members Code11 settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 227: Code39_Setting Structure

    Code39_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct Code39_Setting UINT m_uiRead; UINT m_uiChkDig; UINT m_uiXmitChkDig; UINT m_uiCodeID; UINT m_uiFullASCII; UINT m_uiXmitStarStop; UINT m_uiPharmacode; UINT m_uiPharmacodeOnly; Members All members Code39 settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 228: Code93_Setting Structure

    Code93_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct Code93_Setting UINT m_uiRead; UINT m_uiCodeID; Members All members Code93 settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 229: Code128_Setting Structure

    Code128_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct Code128_Setting UINT m_uiRead; UINT m_uiCodeID; UINT m_uiUCCEAN128; UINT m_uiISBT128; UINT m_uiISBT128XmitID; UINT m_uiISBT128Concat; UINT m_uiISBT128Form; Members All members Code128 settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 230: Codabar_Setting Structure

    Codabar_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct Codabar_Setting UINT m_uiRead; UINT m_uiChkDig; UINT m_uiXmitChkDig; UINT m_uiCodeID; UINT m_uiXmitStarStop; UINT m_uiDualField; Members All members Codabar settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 231: Ean8_Setting Structure

    EAN8_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct EAN8_Setting UINT m_uiRead; UINT m_uiXmitChkDig; UINT m_uiCodeID; UINT m_uiConvertToEAN13; Members All members EAN8 settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 232: Ean13_Setting Structure

    EAN13_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct EAN13_Setting UINT m_uiRead; UINT m_uiXmitChkDig; UINT m_uiCodeID; UINT m_uiISBNConvert; UINT m_uiISBNSuppReq; UINT m_uiISMNConvert; UINT m_uiISMNSuppReq; Members All members EAN13 settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 233: Industrial25_Setting Structure

    Industrial25_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct Industrial25_Setting UINT m_uiRead; UINT m_uiCodeID; Members All members Industrial 2 of 5 settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 234: Interleaved25_Setting Structure

    Interleaved25_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct Interleaved25_Setting UINT m_uiRead; UINT m_uiChkDig; UINT m_uiXmitChkDig; UINT m_uiCodeID; Members All members Interleaved 2 of 5 settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 235: Msi_Setting Structure

    MSI_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct MSI_Setting UINT m_uiRead; UINT m_uiChkDig; UINT m_uiXmitChkDig; UINT m_uiCodeID; Members All members MSI Plessey settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 236: Uk_Setting Structure

    UK_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct UK_Setting UINT m_uiRead; UINT m_uiXmitChkDig; UINT m_uiCodeID; Members All members UK Plessey settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 237: Telepen_Setting Structure

    Telepen_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct Telepen_Setting UINT m_uiRead; UINT m_uiCodeID; UINT m_uiFullASCII; Members All members Telepen settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 238: Upca_Setting Structure

    UPCA_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct UPCA_Setting UINT m_uiRead; UINT m_uiXmitChkDig; UINT m_uiCodeID; UINT m_uiConvertToEAN13; UINT m_uiCoupon; UINT m_uiCouponXmitID; UINT m_uiXmitNumSys; Members All members UPCA settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 239: Upce_Setting Structure

    UPCE_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct UPCE_Setting UINT m_uiRead; UINT m_uiXmitChkDig; UINT m_uiCodeID; UINT m_uiConvertToUPCA; UINT m_uiXmitNumSys; Members All members UPCE settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 240: Matrix25_Setting Structure

    Matrix25_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct Matrix25_Setting UINT m_uiRead; UINT m_uiChkDig; UINT m_uiXmitChkDig; UINT m_uiCodeID; Members All members Matrix25 settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 241: Uegeneral_Setting Structure

    UEGeneral_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct UEGeneral_Setting UINT m_uiSuppReq; UINT m_ui2DigSupp; UINT m_ui5DigSupp; UINT m_ui2DigRedu; UINT m_ui5DigRedu; UINT m_uiGTIN; Members All members UPC/EAN General settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 242: Iata25_Setting Structure

    IATA25_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct IATA25_Setting UINT m_uiRead; UINT m_uiCodeID; Members All members IA TA2 of 5 settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 243: Trioptic_Setting Structure

    Trioptic_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct Trioptic_Setting UINT m_uiRead; UINT m_uiCodeID; UINT m_uiConversion; Members All members TRI-OPTIC settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 244: Rss_Setting Structure

    RSS_Setting Structure This setting file contains information used by Structure ScannerSetting. Struct RSS_Setting UINT m_uiRead; UINT m_uiXmitAppID; UINT m_uiXmitChkDig; UINT m_uiXmitSymID; Members All members settings in Scan Command Table . Structure Information Header: scanapiax.h Device: PT90 PT-90 Mobile Computer SDK Programming Manual...
  • Page 245: Scan Command Table

    Scan Command Table Command1 Command2 Value 0: Disable Indication LED indication 1: Enable * 0: Disable Buzzer indication 1: Enable * 0: Disable * Vibrator 1: Enable 0: Disable * Resume System Using ScanKey 1: Enable 0: Before code data * Transmission Code ID position 1: After code data...
  • Page 246 1~30 See Note 3 Scan Timeout (Sec) 0~255 (0: Disable) See Note 3 Idle Timeout (Sec) 0x01 ~ 0x7F ASCII code (1-10 characters) String setting Preamble characters settings 00 * 0x01 ~ 0x7F ASCII code (1-10 characters) Postamble characters settings 00 * 0: Disable * Code 11...
  • Page 247 0: Disable * Code ID setting 0x01 ~ 0x7F ASCII code(1 bytes) 0: Disable * UCC/EAN 128 1: Enable 0: Disable * ISBT 128 1: Enable 0: Disable ISBT 128 Transmit Identifier Data 1: Enable * 0: Disable ISBT 128 Concatenation 1: Enable * 0: =A + =% * ISBT 128 Form:...
  • Page 248 EAN 13 Read 1: Enable * 0: Disable Transmit Check Digit 1: Enable * 0: Disable * Code ID setting 0x01 ~ 0x7F ASCII code(1 bytes) 0: Disable * ISBN conversion 1: Enable 0: Disable * ISBN Supplement Required 1: Enable 0: Disable * ISMN conversion 1: Enable...
  • Page 249 0: Disable * Code ID setting 0x01 ~ 0x7F ASCII code(1 bytes) 0: Disable * Telepen Read 1: Enable 0: Disable * Code ID setting 0x01 ~ 0x7F ASCII code(1 bytes) 0: Disable * Full ASCII 1: Enable 0: Disable UPCA Read 1: Enable *...
  • Page 250 0: Disable * Code ID setting 0x01 ~ 0x7F ASCII code(1 bytes) 0: Disable * UPC/EAN General Supplements Required 1: Enable 0: Disable * Two Digit Supplements 1: Enable 0: Disable * Five Digit Supplements 1: Enable 0: Disable * Two Digit Redundancy 1: Enable 0: Disable *...
  • Page 251 Note1: This command will set all barcode ID settings to proprietary value. It can' t be queried. Barcode value Barcode value Code 11 MSI Plessey Code 39 UK Plessey Code 93 Telepen Code 128 UPCA Codabar UPCE EAN8 Matrix 25 EAN13 IA TA 25 Industrial 2 of 5...
  • Page 252 Example: Cmd1 Cmd2 Value 670C 6514 6710 Code 128: Can only read barcode of 12- or 16-digit. Code 39: Can only read barcode of 20-digit. Note 3: ScanTimeout: the maximum time, in seconds, allowed during which the scanning beam remains ON without decoding any barcode.
  • Page 253: Function Return V Alues

    Function Return Values Constant Value Description E_FUNC_SUCCEED 0x00000000 The function returned without error. E_FUNC_ERROR 0x00000001 The function returned error. E_FUNC_NULLPTR 0x00000002 A null pointer was passed to the function. E_FUNC_PAR_ERROR 0x00000003 An invalid parameter was passed to the function. E_FUNC_SCANNER_NOT_OPEN 0x00000004 The scanning device is not enabled.

Table of Contents