IContextNode::AddPropertyData method

Adds a piece of application-specific data.

Syntax

HRESULT AddPropertyData(
  [in] const GUID  *pPropertyDataId,
  [in]       ULONG ulPropertyDataSize,
  [in]       BYTE  *pbPropertiesData
);

Parameters

pPropertyDataId [in]

A globally unique identifier (GUID) that is used to identify the type of data.

ulPropertyDataSize [in]

The size of the data in bytes.

pbPropertiesData [in]

[in, size_is(ulPropertyDataSize)]

An 8-bit unsigned integer array containing the property information to add.

Return value

For a description of the return values, see Classes and Interfaces - Ink Analysis.

Remarks

Use IContextNode::AddPropertyData to associate data with a context node. To retrieve the data later, use IContextNode::GetPropertyData.

The ink analyzer may delete the node as part of ink analysis, unless the context node is confirmed (see IContextNode::Confirm). 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::GetPropertyData

IContextNode::GetPropertyDataIds

IContextNode::ContainsPropertyData

IContextNode::LoadPropertiesData

IContextNode::RemovePropertyData

IContextNode::SavePropertiesData