IXMLDOMDocument::selectNodes Method

Applies the specified pattern-matching operation to this node's context and returns the list of matching nodes.

Syntax

HRESULT selectNodes(
    BSTR patternString,
    IXMLDOMNodeList** resultList);

Parameters

patternString

[in] XSL pattern that is to be matched, based on the context defined by this node.

resultList

[out] List of nodes that match the pattern. If no nodes match the pattern, an empty node list is returned.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

For a complete description of the pattern syntax, see XSL Pattern-Matching Syntax.
The selectSingleNode method is much like the selectNodes method, but returns only the first matching node rather than the list of all matching nodes.
The IXMLDOMNodeList is live and immediately reflects changes to the nodes that appear in the list.