IXMLDOMDocument::nodeFromID Method

Returns the node whose ID attribute matches the supplied value.

Syntax

HRESULT nodeFromID(
    BSTR idString,
    IXMLDOMNode ** node);

Parameters

idString

[in] Value of the ID to match.

node

[out] Node that matches the supplied ID. If no nodes match, returns NULL.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

According to the XML 1.0 Recommendation (REC-xml-19980210), ID attribute values must be unique within their XML documents, and no element can specify more than one ID attribute.

This method was designed to handle ID/IDREF relationships in XML, but does not require an attribute of type IDREF. It can be used generically similar to the all collection in DHTML.