Programming with Reflection

image\rwnprg32.gif XmodemReceiveFile method

 

Syntax object.XmodemReceiveFile LocalFile, [TransferType], [IfFileExists]

 

Description

Transfers a file from the host to the PC, using the Xmodem file transfer protocol.

Arguments

LocalFile Argument Type: String
Required
Specifies the local file name to use for the file. This string can contain drive and path information. This string cannot contain wildcard characters.

TransferType Argument Type: Enumeration
Optional
Specifies what type of file is being transferred. The default is rcBinary. The possible values are:

 rcASCII

 Specifies an ASCII file transfer. If the XmodemTranslateCharacters property is set to True, the following translations are performed:

· Character set translations (as specified on the Emulation tab in the Terminal Setup dialog box).

· Relevant ASCII File Translation options (as specified on the Translation tab in the File Transfer Setup dialog box).

 If XmodemTranslateCharacters is set to False, record separator characters may still be translated to carriage return/linefeed sequences (if the ConvertSeparatorToEOL property is set to True), and a Ctrl+Z character may still be appended to the end of the file (if the WriteCtrlZAsEOF property is set to True), but no other translations are performed.

 rcBinary

 Binary file transfer. Data in the file is not translated as it is transferred.

IfFileExists Argument Type: Enumeration
Optional
Specifies what to do if the sent file already exists on the PC. The default is rcCancel. The possible values are:

 rcAskUser

 Prompts the user to specify what should be done.

 rcCancel

 Stops the transfer.

 rcDelete

 Deletes (overwrites) the existing file.

 rcAppend

 Appends the contents of the host file to the existing PC file.

 

image\jump.gif Keyword Index

image\popup.gif Related Topics

image\popup.gif Reflection products that use this command