Translate page

GetSessions.Method (String, Int32)


Retrieves information about the currently active sessions.

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

Syntax


C#
public StatusCode GetSessions(
	ref string sessions,
	out int numberOfSessions
)
Visual Basic (Declaration)
Public Function GetSessions ( _
	ByRef sessions As String, _
	<OutAttribute> ByRef numberOfSessions As Integer _
) As StatusCode
Visual C++
public:
virtual StatusCode GetSessions(
	String^% sessions, 
	[OutAttribute] int% numberOfSessions
) sealed
JavaScript
function GetSessions(sessions, numberOfSessions);

Parameters

sessions Type: System..::.String %Buffer to hold session information. The sessions parameter will on successful return contain session information for each active host session in the following format: String position Meaning 1 Session ID character. 2 - 9 Session long name, always 8 spaces for QWS. 10 Session type: "H" for 'host', "P" for 'personal computer.' 11 - 12 Size of the presentation space, expressed as a binary number.

numberOfSessions Type: System..::.Int32 %If the return value is Ok or ParameterError, this will contain the number of active host sessions at the time of the call. Note that there is no guarantee that a session that was open at the time of the call can not be closed or disconnected by the time this method returns.

Return Value

The StatusCode indicating the result of the operation.

This can be one of the following values:


Status codeDescription
OkInformation on host sessions retrieved successfully.
WHLLPARAMETERERRORThe size of the buffer was too small; use the numberOfSessions parameter return value to calculate the correct buffer size.
WHLLSYSERRORA system error occurred.

Implements

IApplication..::.GetSessions(String%, Int32%)

See Also

Send comments on this topic to Jolly Giant Software

Copyright 2009 by Jolly Giant Software, Inc.