Attempts to connect to the session specified in the object.

Namespace: JollyGiant.Emulation
Assembly: JGSComdotNet (in JGSComdotNet.dll) Version: 1.0.0.0 (1.0.0.0)

Syntax

C#
public StatusCode Connect( Object sessionId )

Visual Basic (Declaration)
Public Function Connect ( _ sessionId As Object _ ) As StatusCode

Visual C++
public: virtual StatusCode Connect( Object^ sessionId ) sealed

JavaScript
function Connect(sessionId);

Parameters

sessionId Type: System..::.ObjectThe single character ID of the session to connect to.

Return Value

Returns the StatusCode of the connection attempt. The returned value can be one of the following:

Status code	Description
WHLLOK	Connect request successful, and the specified session is unlocked and ready for input.
WHLLNOTCONNECTED	Connect request failed, specified session ID is invalid.
WHLLPSBUSY	Connect request successful, but the specified session is busy.
WHLLINHIBITED	Connect request successful, but the specified session is locked (input inhibited).
WHLLSYSERROR	Connect request failed due to a system error.
WHLLUNAVAILABLE	Connect request failed, specified session is unavailable (already in use).

Implements

ISession..::.Connect(Object)

Remarks

In order to communicate with an instance of QWS, you will need to specify which session you want to exchange information with. Some methods take a session identifier to specify the instance. Others require that your application is already connected to an instance, and will use that connected instance. The Connect method allows you to connect your application to a QWS session.

Connect will accept objects of type String, Int32, UInt32, Int16, Int32, UInt16, UInt32 and Char

Examples

C#

Connect("A");
    // or
Connect('a');
    // or
Connect(65);
    // or
byte iid = 65;
Connect(iid);

Connect_Method