IXMLDOMDocument::selectSingleNode Method

Applies the specified pattern to this node's context and returns the first matching node.

Syntax

HRESULT selectSingleNode(
    BSTR patternString,
    IXMLDOMNode** resultNode);

Parameters

patternString

[in] Pattern that is to be matched; applied to this node's context.

resultNode

[out] First node that matches the specified pattern. If no nodes match, returns NULL.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

For a complete description of XSL patterns, 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.