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 the GetLastError function.

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

OS Versions: Windows CE .NET 4.0 and later.
Header: Recog.h.
Link Library: Hwxjpn.lib, Hwxusa.lib, Hwxcht.lib, Hwxkor.lib.

See Also

HwxCreate | HwxGetResults

 Last updated on Friday, April 09, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.