IXMLDOMSelection::peekNode Method

Gets the next node that nextNode will return without advancing the list position.

Visual Basic Syntax

Set objXMLDOMNode = objXMLDOMSelection.peekNode

C/C++ Syntax

HRESULT peekNode (IXMLDOMNode** ppNode);

Parameters

ppNode [out]

The returned node, or Null if there are no more nodes or if E_PENDING is returned.

C/C++ Return Values

S_OK

Value returned if the method is successful.

E_PENDING

Value returned if the context document is still being built and the selection object has hit the end of the available nodes to match.

Remarks

Like nextNode, peekNode does not result in a snapshot of all matching nodes. Consecutive calls to peekNode will produce the same node over and over, independent of changes in the underlying tree.

See Also

IXMLDOMSelection Interface