User`s guide

cxxii Contents
Code Description
WHLLOK The function was successful.
WHLLNOTCONNECTED An invalid presentation space was specified.
WHLLPARAMETERERROR An invalid option was specified.
WHLLSYSERROR The function failed due to a system error.
WHLLNOTSUPPORTED The function is not supported by the emulation program.
WHLLSFACONN The function failed because another application is already
connected to this session.
WHLLSFDDM The function failed because a DDM session is already
connected to this session.
Windows HLLAPI scans the query reply buffers for the destination/origin ID (DOID) self-defining
parameter (SDP) to obtain the contents of the DOID field of the query reply (that the workstation must
supply). A value of X'0000' will cause the emulator to assign a DOID to the workstation application
and WinHLLAPI will fill in the DOID field of the query reply with the assigned ID. If the value
specified is non-zero, the emulator will assign the specified value as the workstation application’s
DOID, assuming that the ID has not been previously assigned. If the specified DOID is already in use,
a return code of 2 will be returned by WinHLLAPI.
The application must build the query reply data structures within the application’s private memory
space. See Appendix D, “Query Reply Data Structures for Windows HLLAPI” for detailed information
about structured field usage for the query reply data structures that are supported by WinHLLAPI.
The 2-byte length field at the beginning of each query reply must not be byte-reversed by the
application.
Cursory checking is performed on the query data reply (only the ID and the length of the structure are
checked for validity).
The semaphore determines if the state of the structured field connection is set (disabled) or clear
(enabled). If the emulator, for example, is in a state that allows processing of a structured field, the
semaphore will be clear. If the emulator cannot currently process a structured field, the semaphore will
be set. Be sure to check the status of the structured field semaphore before attempting a Read
Structured Field (126) or a Write Structured Field (127) function call.
Return Codes
Remarks