are registered trademarks, the Attachmate logo is a trademark and

WINHLLAPI LANGUAGE REFERENCE
For Function 51, “Get Key,” TWAIT does not return control to the WinHLLAPI client
application program until it has intercepted a key (a normal or AID key, based on the
option code specified under Function 50, “Start Keystroke Intercept” ).
LWAIT
For Function 4, “Wait,” LWAIT waits until XCLOCK / XSYSTEM clears. This option is
not recommended because XSYSTEM or permanent XCLOCK will prevent control
being returned to the application.
For Function 51, “Get Key,” LWAIT does not return control to your application until it
has intercepted a key. The intercepted key could be a normal or AID key, based on
the option specified under Function 50, “Start Keystroke Intercept.”
NWAIT
For Function 4, “Wait,” NWAIT checks status and returns immediately (no wait).
For Function 51, “Get Key,” NWAIT returns code 25 (keystroke not available) if
nothing matching the option specified under Function 50, “Start Keystroke
Intercept,” is queued.
Return parameters
Parameters accepted
Function replaces the value of call parameter Data length with the number of session
parameters that were set.
Result code
Function replaces the value of call parameter PS position with one of the following
codes:
Code
Description
0 The function was successful.
2 One or more parameter names were not recognized; all recognized
parameters were accepted.
9 A system error occurred.
Example
/* Set session parameters */
WORD HllFunc = 9;
char HllDataStr[20];
strcpy (HllDataStr,"SRCHFROM,SRCHFRWD");
/* Length of parameter string */
WORD HllDataLgth = 17;
WORD PsPos;
WinHLLAPI(&HllFunc, HllDataStr, &HllDataLgth, &PsPos);
Prepared by Attachmate Technical Support 35