Connect Presentation Space

Connect Presentation Space – Function 1

This function establishes a connection between a specified presentation space (session) on the Host and your Windows HLLAPI application.

Prerequisite functions

None.

Function call

WinHLLAPI(CONNECTPS,lpbyString,lpwLength,lpwReturnnCode)

Call parameters

Parameter	Description
Data String	One-character short name session ID of the Host session to connect with, either an upper- or lower-case letter.
Data Length	NA (defaults to 1).
PS Position	NA

Return code

Code	Description
WHLLOK	The keystrokes were sent successfully.
WHLLNOTCONNECTED	Your Windows HLLAPI application is currently not connected to a Host session.
WHLLPSBUSY	Connect request successful, but the specified session is busy.
WHLLINHIBITED	Connect request successful, but the specified session is locked (input inhibited).
WHLLSYSERROR	The function failed due to a system error.
WHLLUNAVAILABLE	Connect request failed, specified session is unavailable (already in use).

Remarks

When using the WinHLLAPI( ) call, you can only make connected sessions available to other Windows HLLAPI applications by issuing a Disconnect Presentation Space call. Issuing a Reset System call causes your Windows HLLAPI application to disconnect from all Host sessions. Alternatively, your Windows HLLAPI application can share the Presentation Space by setting the appropriate read/write parameters in the Set Session Parameters call (Function 9).