IContextNode::CreatePartiallyPopulatedSubNode method
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 |
|
| DLL |
|