IInkAnalyzer::SaveResultsForNodes method

Article
01/07/2021

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