Share via

HwxDestroy

  • Article

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

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.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.0 and later Recog.h   Hwxjpn.lib, Hwxusa.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

HwxCreate

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.