IInkAnalyzer::SaveResultsForNodes method

Saves analysis results for a specific context node collection associated with an IInkAnalyzer.

Syntax

HRESULT SaveResultsForNodes(
  [in]      IContextNodes *pContextNodes,
  [in, out] ULONG         *pulSerializedDataSize,
  [out]     BYTE          **ppbSerializedData
);

Parameters

pContextNodes [in]

The IContextNode collection for which to save analysis results.

pulSerializedDataSize [in, out]

The number of bytes in ppbSerializedData.

ppbSerializedData [out]

Pointer to the serialized analysis data.

Return value

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

Remarks

Caution

To avoid a memory leak, call CoTaskMemFree on *ppbSerializedData when you no longer need the information.

This method saves the current analysis results for the IContextNode objects in pContextNodes and all of their ancestor and descendant context nodes. This method does not save any stroke data. It is the responsibility of your application to synchronize any analysis results and corresponding stroke data, if it persists.

If the IContextNode object to be saved is only partially populated, this method returns an error code (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::SaveResults Method

IInkAnalyzer::SaveResultsForStrokes Method

IContextNode

Ink Analysis Reference