peekNode Method
A version of this page is also available for
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: