
Handheld Terminal
Software
User's Manual, Version: 1.3
67
© KEBA 2007
7.5 Update API Design
All required methods for an image update are implemented in one single
dynamic link library (update.dll). All functions described in this document
are exported from this DLL.
For running the update.dll the appropriate KetopAPI.dll will be necessary.
Both DLL files must exist in the image and correspond with each other.
7.5.1 Handling of Errors
Rules
z
All functions expecting any input parameter check if the parameter is lo-
cated inside the range and if its data type is correct. If a parameter is lo-
cated outside the range the function will return
ERROR_INVALID_RANGE.
Defines
OK 0
SUCCESS 0
FAIL 1
ERROR_INVALIDE_RANGE 100
ERROR_IMGUPD_INIT 101
ERROR_IMGUPD_FILEOPEN 102
ERROR_IMGUPD_WRONGIMG 103
ERROR_IMGUPD_PROGRAMERROR 104
ERROR_IMGUPD_TOMUCHUPD 105
ERROR_PROGRAM_FLASH_BURN 106
ERROR_PROGRAM_FLASH_ERASE 107
ERROR_IMGUPD_NOTEQUAL 108
ERROR_IMGUPD_FILEWRITE 109
ERROR_IMGUPD_FILEREAD 110
ERROR_WRONG_FILE_HEADER 111