are registered trademarks, the Attachmate logo is a trademark and

WINHLLAPI LANGUAGE REFERENCE
Function 6
Data string
Data length
PS position
Text to be searched for in the PS
Length of the data string. (Ignored if in EOT mode.)
Start position where the search function is to begin (SRCHFRWD) or to end
(SRCHBKWD). This parameter is ignored if SRCHALL is set.
Return parameters
PS Position
Function replaces the value of call parameter Data length with the PS position where
specified text was found, or 0 if the text was not found.
Result code
Function replaces the value of call parameter PS position with one of the following
codes:
Code
Description
0 The function was successful (the specified text was found).
1 The application was not connected with a host PS.
2 An incorrect parameter was entered.
7 An invalid PS position was specified for beginning the search
9 A system error occurred
24 The specified text was not found.
Example
Notes
WORD HllFunc = 6;
char HllDataStr[10];
/* Text to search for: "Hello" */
strcpy (HllDataStr, "Hello");
WORD HllDataLgth = 5;
/* Start search at PS position 199 */
WORD PsPos = 199;
WinHLLAPI(&HllFunc, HllDataStr, &HllDataLgth, &PsPos);
• The SRCHFROM option is useful when you are searching for a string that may
occur several times.
• The search carried out by this function is case-sensitive.
• To determine when the host is ready for input, the application should search
the screen for key fields, usually near the bottom of the screen.
Prepared by Attachmate Technical Support 25