IContextLink::GetSourceNode method

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

Syntax

HRESULT GetSourceNode(
  [out] IContextNode **ppSrcContextNodeId
);

Parameters

ppSrcContextNodeId [out]

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

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

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

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

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

ContextLinkDirection

Ink Analysis Reference