IInkAnalyzer::SaveResultsForStrokes method

Article
01/07/2021

Saves analysis results for the specified strokes associated with an IInkAnalyzer.

Syntax

HRESULT SaveResultsForStrokes(
  [in]          ULONG ulStrokeIdsCount,
  [in]          LONG  *plStrokeIds,
  [in, out]     ULONG *pulSerializedDataSize,
  [out, retval] BYTE  **ppbSerializedData
);

Parameters

ulStrokeIdsCount [in]: The number of stroke identifiers in plStrokeIds.
plStrokeIds [in]: The array of stroke identifiers.
pulSerializedDataSize [in, out]: The number of bytes in ppbSerializedData.
ppbSerializedData [out, retval]: 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 specified strokes. This method saves the ink leaf IContextNode objects containing the strokes and all of the ancestors of those context nodes. This method does not save any stroke data or analysis hint nodes. It is the responsibility of your application to synchronize any analysis results and corresponding stroke data, if it persists.

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