GetGuideHRC

Retrieves the guide structure being used in a recognition context HRC.

int GetGuideHRC( HRC hrc, LPGUIDE lpguide, UINT FAR * lpnFirstVisible )

Parameters
hrc

Handle to the HRC object.

lpguide

Address of a GUIDE structure; all coordinates are in screen coordinates. This parameter cannot be NULL.

lpnFirstVisible

Pointer to first visible character or line, or NULL. For boxed controls, this is the first visible box (leftmost and topmost for left-right, top-down languages like English). For other controls, this is the first visible character position (left-most for English) in a single-line control, and the first visible line (topmost for English) in multiline controls.

If set to NULL, lpnFirstVisible is ignored.

Return Value
Returns HRCR_OK if successful; otherwise, returns one of the following negative values:

Constant	Description
HRCR_ERROR	Invalid parameter or other error.
HRCR_MEMERR	Insufficient memory.
HRCR_UNSUPPORTED	The recognizer does not support this function.