IContextNode::AddContextLink method

Adds a new IContextLink to the IContextNode object's collection of context links.

Syntax

HRESULT AddContextLink(
  [in]  IContextNode         *pDestinationNode,
  [in]  ContextLinkDirection linkDirection,
  [out] IContextLink         **ppContextLinkToAdd
);

Parameters

pDestinationNode [in]

The destination IContextNode for the new IContextLink.

linkDirection [in]

The direction of IContextLink object to create.

ppContextLinkToAdd [out]

A pointer to the new IContextLink object.

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 *ppContextLinkToAdd when you no longer need to use the context node.

This IContextNode object is the source node (see IContextLink::GetSourceNode) for the new IContextLink object.

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

IContextLink

IContextLinks

ContextLinkDirection

IContextNode::DeleteContextLink

IContextNode::GetContextLinks

Ink Analysis Reference