Share via


IXMLDOMElement Interface

The IXMLDOMElement interface represents the element object. For more information, see the Microsoft XML SDK 3.0 documentation available at the Microsoft Web site.

In addition to the methods inherited from the IXMLDOMNodeIXMLDOMNode Interface, the IXMLDOMElement interface exposes the following methods.

Method

Description

get_tagName

Retrieves the element name(that appears within the tag).

getAttribute

Retrieves the value of the named attribute.

getAttributeNode

Retrieves the named attribute node.

getElementsByTagName

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

removeAttribute

Removes or replaces the named attribute.

removeAttributeNode

Removes the specified attribute from this element.

setAttribute

Specifies the value of the named attribute.

setAttributeNode

Adds or changes the supplied attribute node on this element.

Remarks

Element nodes are among the most common objects in the XML document tree. Element nodes can have attributes associated with them. By definition, attributes are not defined as child nodes of the element and are not considered to be part of the document tree. Accordingly, the IXMLDOMElement object provides methods to make it easier to manage attributes, including methods to associate an attribute with an element, and to retrieve an attribute object and the attribute value by name.

To retrieve the set of all attributes associated with the element, you can also call the getAttribute method, which returns an IXMLDOMNamedNodeMap collection object that contains all the element's attributes.

Example

The following example retrieves a pointer to an IXMLDOMElement interface and assigns it as the new document element of an XML document.

#include “wmsserver.h”
#include <atlbase.h> // Includes CComVariant and CComBSTR.

// Declare variables.
IWMSServer*           pServer;
IXMLDOMDocument*      pPlaylist;
IXMLDOMElement*       pXMLElement;

HRESULT               hr;
CComVariant           varFile;
VARIANT_BOOL          bIsSuccessful;
CComBSTR              bstrName;

// Initialize the COM library and retrieve a pointer
// to an IWMSServer interface.
hr = CoInitialize(NULL);
hr = CoCreateInstance(CLSID_WMSServer, NULL, CLSCTX_ALL, 
       IID_IWMSServer, (void**)&pServer);
if (FAILED(hr)) goto EXIT;

// Create the playlist object.
hr = pServer->CreatePlaylist(&pPlaylist);

// Load a sample playlist file.
varFile = "c:\\wmpub\\wmroot\\simple.wsx";
hr = pPlaylist->load(varFile, &bIsSuccessful);
if (FAILED(hr)) goto EXIT;

if (bIsSuccessful)
{
    // Create a new element named "root."
    bstrName = "root";
    hr = pPlaylist->createElement(bstrName, &pXMLElement);
    if (FAILED(hr)) goto EXIT;

    // Assign pXMLElement as the new document element
    // for the XML document.
    hr = pPlaylist->putref_documentElement(pXMLElement);
    if (FAILED(hr)) goto EXIT;
}

EXIT:
    // TODO: Release temporary COM objects and uninitialize COM.

See Also

Reference

IXMLDOMNamedNodeMap Interface

IXMLDOMNode Interface