lsxECLSession Class

The lsxECLSession class provides information about a host-connected connection. The lsxECLSession class also contains several other objects that correspond to the various pieces of a host-connected connection.

An lsxECLSession object is associated with a Personal Communications connection when the lsxECLSession object is created. You cannot change the connection that is associated with an lsxECLSession object. If you want to manage a different connection, you must create a new lsxECLSession object associated with that connection.

There are two ways to create an lsxECLSession object:
  • Create a new lsxECLSession 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 shows how to create an lsxECLSession object that is associated with Personal Communications connection A:
    ' Create an lsxECLSession object associated with PCOMM connection A
     dim mySessObj as new lsxECLSession("A")
  • Create a new lsxECLSession 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 and lsxECLConnection Class for more information on the properties and methods of those objects). The following example shows how to create an lsxECLSession object using a Personal Communications connection handle:
    dim mySessObj as lsxECLSession
    dim myConnObj as new lsxECLConnection
     
    ' Create a new lsxECLSession object using a connection handle
    set mySessObj = new lsxECLSession(myConnObj.Handle)
When an lsxECLSession object is created, contained lsxECLSession, lsxECLOIA, lsxECLXfer, and lsxECLWinMetrics objects are also created. Refer to them as you would any other property. The following is an example of accessing the lsxECLWinMetrics object within an lsxECLSession object:
' Set the host window to minimized
  mySessObj.lsxECLWinMetrics.Minimized = 1