User`s guide

Contents xix
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.
WinHLLAPI(CONNECTPS,lpbyString,lpwLength,lpwReturnnCode)
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
Code Description
WHLLOK Connect request successful and the specified session is
unlocked and ready for input.
WHLLNOTCONNECTED Connect request failed, specified short name 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).
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).
Function Call
Call Parameters
Return Codes
Remarks