IInkAnalyzer::SaveResults method

Saves all analysis results for an IInkAnalyzer.

Syntax

HRESULT SaveResults(
  [out] ULONG *pulSerializedDataSize,
  [out] BYTE  **ppbSerializedData
);

Parameters

pulSerializedDataSize [out]

The number of bytes in ppbSerializedData.

ppbSerializedData [out]

An array containing the saved analysis results.

Return value

For a description of the return values, see Classes and Interfaces - Ink Analysis.

Remarks

Caution

To avoid a memory leak, use CoTaskMemFree to release the memory from *ppbSerializedData when you no longer need the information.

This method saves all the current analysis results, which include current analysis hint and custom recognizer nodes (see IContextNode::GetType). This method does not save any stroke data. It is the responsibility of your application to synchronize any analysis results and corresponding strokes if it persists data.

This method returns an error code when an IContextNode object to save is partially populated (see IContextNode::GetPartiallyPopulated).

Requirements

Requirement Value
Minimum supported client
Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server
None supported
Header
IACom.h (also requires IACom_i.c)
DLL
IACom.dll

See also

IInkAnalyzer

IInkAnalyzer::LoadResults Method

IInkAnalyzer::SaveResultsForNodes Method

IInkAnalyzer::SaveResultsForStrokes Method

IContextNode

Ink Analysis Reference