Return
codes.
This function returns an integer (cHits) indicating, where appropriate,
whether correlation hits were detected:
GPI_OK
GPI_HITS
Successful with correlate hit (returned
by display drivers when the correlate flag is ON, and a hit is detected)
GPI_ERROR
Possible
Errors Detected: When an error is detected, the handling routine must
call WinSetErrorInfo to post the condition. Error codes for conditions that
the handling routine is expected to check include:
Refer to the "Error Explanations"
section in the Presentation Manager Programming Reference for further
explanation.