IContextNode::CreateSubNode method

Creates a new child IContextNode object.

Syntax

HRESULT CreateSubNode(
  [in]  const GUID         *pNodeType,
  [out]       IContextNode **ppContextNodeCreated
);

Parameters

pNodeType [in]

A GUID that represents the type of IContextNode to create.

ppContextNodeCreated [out]

A pointer to the new 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 *ppContextNodeCreated 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 a list of context node types, see Context Node Types.

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::DeleteSubNode

Ink Analysis Reference