InfoConnect VBA Guide
Attachmate.Reflection.Objects.Emulation.OpenSystems Library / FileTransfer Object / XmodemReceiveFile Method
Specifies the local filename to use for the file. This string can contain drive and path information. This string cannot contain wildcard characters.
A TransferTypeOption value that specifies what type of file is being transferred. The default is TransferTypeOption.Binary. The possible values are: TransferTypeOption.ASCII 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. TransferTypeOption.Binary Binary file transfer. Data in the file is not translated as it is transferred.
A DestinationFileExistsOption value that specifies what to do if the sent file already exists on the PC. The default is DestinationFileExistsOption.Cancel. The possible values are: DestinationFileExistsOption.AskUser Prompts the user to specify what should be done. DestinationFileExistsOption.Cancel Stops the transfer. DestinationFileExistsOption.Delete Deletes (overwrites) the existing file. DestinationFileExistsOption.Append Appends the contents of the host file to the existing PC file.
In This Topic
    XmodemReceiveFile Method
    In This Topic
    Transfers a file from the host to the PC, using the Xmodem file transfer protocol.
    Syntax
    expression.XmodemReceiveFile( _
       ByVal localFile As String, _
       ByVal transferOption As TransferTypeOption, _
       ByVal fileOption As DestinationFileExistsOption _
    ) As ReturnCode
    where expression is a variable that represents a FileTransfer Object

    Parameters

    localFile
    Specifies the local filename to use for the file. This string can contain drive and path information. This string cannot contain wildcard characters.
    transferOption
    A TransferTypeOption value that specifies what type of file is being transferred. The default is TransferTypeOption.Binary. The possible values are: TransferTypeOption.ASCII 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. TransferTypeOption.Binary Binary file transfer. Data in the file is not translated as it is transferred.
    fileOption
    A DestinationFileExistsOption value that specifies what to do if the sent file already exists on the PC. The default is DestinationFileExistsOption.Cancel. The possible values are: DestinationFileExistsOption.AskUser Prompts the user to specify what should be done. DestinationFileExistsOption.Cancel Stops the transfer. DestinationFileExistsOption.Delete Deletes (overwrites) the existing file. DestinationFileExistsOption.Append Appends the contents of the host file to the existing PC file.

    Return Value

    One of the following ReturnCode enumerated values.

    Member Description
    Cancelled Cancelled.
    Error Error.
    PermissionRequired Permission is required.
    Success Success.
    Timeout Timeout condition.
    Truncated The text is truncated.

    See Also