IContextLink::GetDestinationNode method

Retrieves the IContextNode object that is the destination for this IContextLink.

Syntax

HRESULT GetDestinationNode(
  [out] IContextNode **ppDstContextNodeId
);

Parameters

ppDstContextNodeId [out]

A pointer to the IContextNode object that is the destination for this IContextLink.

Return value

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

Remarks

Caution

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

If the IContextLink object links between a node that contains writing and a node that contains drawing, the destination node is generally the node that contains writing.

If the IContextLink object has a link type of Encloses (see IContextLink::GetContextLinkDirection), the destination node is the IContextNode object that is enclosed.

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

IContextLink

IContextLink::GetSourceNode

ContextLinkDirection

Ink Analysis Reference