IContextNode::CreatePartiallyPopulatedSubNode method

Article
01/07/2021

Creates a child IContextNode object that contains only information about type, identifier, and location.

Syntax

HRESULT CreatePartiallyPopulatedSubNode(
  [in]  const GUID            *pNodeType,
  [in]  const GUID            *pNodeId,
  [in]        IAnalysisRegion *pNodeLocation,
  [out]       IContextNode    **pPartiallyPopulatedContextNodeCreated
);

Parameters

pNodeType [in]: The type of context node to create.
pNodeId [in]: The identifier for the new node.
pNodeLocation [in]: The location of the new node.
pPartiallyPopulatedContextNodeCreated [out]: A pointer to the new, partially populated IContextNode.

Return value

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

Remarks

Caution

To avoid a memory leak, call IUnknown::Release on *pPartiallyPopulatedContextNodeCreated when you no longer need to use the context node.

The new IContextNode is added to this context node's collection of child nodes (see IContextNode::GetSubNodes). When there are existing child nodes, the newly created IContextNode is added as the last child node.

For more information about type, identifier, and location, see IContextNode::GetType, IContextNode::GetId, and IContextNode::GetLocation.

This method is used for data proxy as a way to create an IContextNode object in the context node tree before all the information about it is available. For more information, 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