IContextNode::SavePropertiesData method

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

See also

IContextNode

IContextNode::LoadPropertiesData

IContextNode::AddPropertyData

IContextNode::GetPropertyData

IContextNode::RemovePropertyData

IContextNode::GetPropertyDataIds

IContextNode::ContainsPropertyData

Ink Analysis Reference