matches Method (Compact 2013)

3/26/2014

Determines whether the node that is passed is contained in the current collection.

Syntax

objXMLDOMNode = objXMLDOMSelection.matches(objXMLDOMNode);

HRESULT matches(  IXMLDOMNode* pNode,  IXMLDOMNode** ppNode);

Parameters

Script

• objXMLDOMNode
  Object. The node to search for in the current collection.

C/C++

• pNode
  [in] The node that is passed in.

• ppNode
  [out, retval] The matching node, or NULL if no matching node is found.

Return Value

Script

Object. On success, returns the node that was located in the current collection. Otherwise, returns an empty object.

C/C++

• S_OK
  Value returned if method is successful.

• E_INVALIDARG
  Value returned if pNode=NULL.

  An error for cases that are not allowed, as outlined in the Extensible Stylesheet Language (XSL) specification (applied to ID, IDREF, and Ancestor).

Remarks

When matches is called with node A, it returns node B such that if B was set as the context on a query, A is in the query's result set. If no such B node is found, matches returns NULL.

The matches method does not take into account the current context of the query.

This method applies to the following objects and interfaces:

IXMLDOMSelection

Requirements

See Also

Reference

XML DOM Methods