Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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)

Image RemovedSyntax

C#
StatusCode Connect(
	Object sessionId
)


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


Visual C++
StatusCode Connect(
	Object^ sessionId
)


JavaScript
function Connect(sessionId);


Parameters

sessionId
Type: System..::.ObjectThe Object
The 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 codeDescription
WHLLOKConnect request successful, and the specified session is unlocked and ready for input.
WHLLNOTCONNECTEDConnect request failed, specified session ID is invalid.
WHLLPSBUSYConnect request successful, but the specified session is busy.
WHLLINHIBITEDConnect request successful, but the specified session is locked (input inhibited).
WHLLSYSERRORConnect request failed due to a system error.
WHLLUNAVAILABLEConnect request failed, specified session is unavailable (already in use).


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

Image RemovedCopyC#

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

See Also


ISession Interface
JollyGiant.Emulation Namespace
ISession..::.Disconnect()()()

Send comments on this topic to Jolly Giant Software

...