IInkAnalyzer::SaveResultsForStrokes method

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

See also

IInkAnalyzer

IInkAnalyzer::LoadResults Method

IInkAnalyzer::SaveResults Method

IInkAnalyzer::SaveResultsForNodes Method

IContextNode

Ink Analysis Reference