IContextNode::SavePropertiesData method

Article
01/07/2021

Retrieves an array of bytes that contains the application-specific and internal property data for this IContextNode.

Syntax

HRESULT SavePropertiesData(
  [in, out] ULONG *pulPropertiesDataSize,
  [out]     BYTE  **ppbPropertiesData
);

Parameters

pulPropertiesDataSize [in, out]: The size of the data array containing the property information. The value passed in is not used.
ppbPropertiesData [out]: A pointer to an 8-bit unsigned integer array that contains the application-specific and internal property data.

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 *ppbPropertiesData when you no longer need the information.

Use this method when your application maintains its own data structure, which is synchronized with that of the IInkAnalyzer. This method saves the property data that the IInkAnalyzer has set on the IContextNode.

For more information about synchronizing your application data with the IInkAnalyzer, see Data Proxy with Ink Analysis.

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

Share via