IXMLDOMSelection::matches Method

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

Visual Basic Syntax

objXMLDOMNode = objXMLDOMSelection.matches(objXMLDOMNode)

C/C++ Syntax

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

Parameters

pNode [in]

The node that is passed in.

ppNode [out]

Boolean result.

C/C++ Return Values

S_OK

Value returned if method successful.

E_INVALIDARG

Value returned if pNode=NULL.

An error for cases that are not allowed, as outlined in the 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 result set of the query. If no such B node is found, matches returns Null.

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

See Also

IXMLDOMSelection Interface