lsxECLXfer Class

The lsxECLXfer Class provides file transfer services between a host and a client. The transfer is done through a Personal Communications connection and therefore, the lsxECLXfer object must be associated with a Personal Communications connection.

The lsxECLXfer object is associated with a Personal Communications connection when the lsxECLXfer object is created. You cannot change the connection that is associated with an lsxECLXfer object. If you want to transfer files on a different connection, you must create a new lsxECLXfer object associated with that connection.

There are three ways to create an lsxECLXfer object:
  • Create a new lsxECLXfer object by passing a Personal Communications connection name as a parameter on the new statement. A Personal Communications connection name is a single, alphabetic character from A-Z or a-z. The following is an example of creating an lsxECLXfer object that is associated with Personal Communications connection A:
    ' Create an lsxECLXfer object associated with PCOMM connection A
    dim myXferObj as new lsxECLXfer("A")
  • Create a new lsxECLXfer object by passing a Personal Communications connection handle as a parameter on the new statement. A Personal Communications connection handle is a long integer and is usually obtained by querying the lsxECLConnection object corresponding to the target Personal Communications connection (see lsxECLConnMgr Class, lsxECLConnList Class and lsxECLConnection Class for more information on the properties and methods of those objects). The following is an example of creating an lsxECLXfer object using a Personal Communications connection handle:
    dim myXferObj as lsxECLXfer
    dim myConnObj as new lsxECLConnection
     
    ' Create a new lsxECLXfer object using the connection handle
    set myXferObj = new lsxECLXfer(myConnObj.Handle)
  • Create an lsxECLSession object and an lsxECLXfer object is automatically created. Access the lsxECLXfer attribute to get to the lsxECLXfer object contained in the lsxECLSession object. The following is an example of how to access the lsxECLXfer object contained in an lsxECLSession object:
    dim myXferObj as lsxECLXfer
    dim lsxECLSessionObj as lsxECLSession
     
    ' Create a new lsxECLSession object associated with PCOMM connection A
    set lsxECLSessionObj = new lsxECLSession("A")
    ' Get the lsxECLXfer object from the lsxECLSession object
    set myXferObj = lsxECLSessionObj.lsxECLXfer