HwxDestroy

This function destroys a handwriting recognition context (HRC) object.

At a Glance

Header file: Recog.h
Windows CE versions: 2.0 and later

Syntax

BOOL HwxDestroy( HRC hrc );

Parameters

hrc

[in] Handle to the handwriting recognition context (HRC) object.

Return Values

TRUE indicates success. FALSE indicates failure. To get extended error information, call GetLastError.

Remarks

The handwriting recognition engine uses an HRC to process each character that a user draws. Typically, before an application collects user input, it calls the HwxCreate function to create a master HRC. Whenever a new HRC is needed to interpret  another character, an application copies the master HRC to an HRC used for processing. To conserve system resources, use HwxDestroy to remove each HRC after calling HwxGetResults.

After HwxDestroy returns TRUE, the handle hrc is no longer valid. An application should set hrc to NULL to ensure it is not inadvertently used again.

See Also

HwxCreate