Share via


peekNode Method

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/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

Header msxml2.h, msxml2.idl
Library uuid.lib
Windows Embedded CE Windows CE .NET 4.0 and later

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

Other Resources