Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

Returns a list of all descendant elements that match the supplied name.

Script Syntax

Copy Code 
var objXMLDOMNodeList = oXMLDOMElement.getElementsByTagName(
tagName);

Remarks

Script Parameters

tagName

String specifying the name of the element to find. The string "*" matches all descendant elements of this element.

Script Return Value

Object. Returns IXMLDOMNodeListobject containing all elements that match the supplied name.

C/C++ Syntax

Copy Code 
HRESULT getElementsByTagName(
  BSTR 
tagName,
  IXMLDOMNodeList** 
resultList
);

Remarks

C/C++ Parameters

tagName

[in] Name of the element to find. The string "*" matches all descendant elements of this element.

resultList

[out, retval] IXMLDOMNodeListobject containing all elements that match the supplied name.

C/C++ Return Values

S_OK

Value returned if successful.

Requirements

Header msxml2.h, msxml2.idl
Library uuid.lib
Windows Embedded CE Windows CE .NET 4.0 and later

Remarks

Elements appear in the order encountered in a preorder traversal of this element's tree.

Note that the IXMLDOMNodeListobject is returned even if there are no matches. In this case, the length of the list will be set to zero.

The IXMLDOMNodeListis live and immediately reflects changes to the nodes that appear in the list.

This method applies to the following objects and interfaces:

IXMLDOMElementand IXMLDOMNodeList.