SMH Technologies FlashRunner Cube Series, User Manual, Page: 51 / 68

5
49
FlashRunner Cube User’s Manual
FR_ReceiveFile()
Prototype
FR_COMM_ERR WINAPI FR_ReceiveFileA (FR_COMM_HANDLE handle, const char
*protocol, const char *src_filename, const char *dst_path, bool force_transfer, FR_
FileTransferProgressProc progress);
FR_COMM_ERR WINAPI FR_ReceiveFileW (FR_COMM_HANDLE handle, const
wchar_t *protocol, const wchar_t *src_filename, const wchar_t *dst_path, bool force_
transfer, FR_FileTransferProgressProc progress);
Description
Receives a file from the instrument’s internal memory and saves it to the
PC.
Return Value
0
The function call was successful.
!=0
The function call was unsuccessful.
Call the
FR_GetLastErrorMessage()
function to get error
information.
Parameters
handle
Communication handle returned by the
FR_OpenCommPort()
function.
protocol
Transfer protocol. Must be
“ymodem”
.
src_filename
The full filename, including path, of the remote file.
dst_path
The PC path where to store the file.
force_transfer
If
TRUE
, file transfer will be executed even if a file with
the same name and CRC exists on the PC; if
FALSE
,
file transfer will be executed only if necessary.
progress
Address of a callback function that will receive progress
information, or
0
if not used.
http://smh-tech.com.cn sales@smh-tech.com.cn +86-15250087885