Share via

peekNode Method (Compact 2013)

  • Article

3/26/2014

Gets the next node that nextNode Method (IXMLDOMNamedNodeMap) will return without advancing the list position.

Syntax

var objXMLDOMNode = objXMLDOMSelection.peekNode();

HRESULT peekNode (
  IXMLDOMNode** ppNode
);

Parameters

Script

None.

C/C++

  • ppNode
    [out, retval] The returned node, or Null if there are no more nodes or if E_PENDING is returned.

Return Value

Script

Object. Returns the next node without advancing the list position, or Null if there are no more nodes.

C/C++

  • 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.

This method applies to the following interface:

IXMLDOMSelection.

Requirements

Header

msxml2.h,
msxml2.idl

Library

uuid.lib

See Also

Reference

XML DOM Methods