peekNode Method (Windows Embedded CE 6.0)

1/6/2010

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

Script Syntax

var objXMLDOMNode = objXMLDOMSelection.peekNode();

Remarks

Script Parameters

None.

Script Return Value

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

C/C++ Syntax

HRESULT peekNode (
  IXMLDOMNode** ppNode
);

Remarks

C/C++ Parameters

• ppNode
  [out, retval] 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.

Requirements

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

See Also

Reference

XML DOM Methods

Other Resources