Share via

IXMLDOMNamedNodeMap::removeNamedItem

  • Article

banner art

Previous Next

IXMLDOMNamedNodeMap::removeNamedItem

The removeNamedItem method removes an attribute from the collection.

Syntax

  HRESULT removeNamedItem(
 BSTR bstrName,
 IXMLDOMNode** ppNamedItem
);

Parameters

bstrName

[in] BSTR containing the name of the attribute to remove from the collection.

ppNamedItem

[out] Pointer to a pointer to an IXMLDOMNode interface that represents a node removed from the collection. The method returns NULL if the named node is not an attribute. This method calls AddRef internally. To avoid memory leaks, you must call Release when you are finished using the interface.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Example Code

The following example uses the removeNamedItem method to remove an attribute node named "src" from the specified element node.

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

// Declare variables.
IWMSServer*          pServer;
IXMLDOMDocument*     pPlaylist;
IXMLDOMElement*      pXMLElement;
IXMLDOMNamedNodeMap* pXMLNamedNodeMap;
IXMLDOMNode*         pXMLNode;

HRESULT              hr;
CComBSTR             bstrName;
CComVariant          varFile;

// 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);

// Create a media element.
bstrName = "media";
hr = pPlaylist->createElement(bstrName, &pXMLElement);
if (FAILED(hr)) goto EXIT;

// Set the src attribute for the media element.
bstrName = "src";
varFile = "welcome1.asf";
hr = pXMLElement->setAttribute(bstrName, varFile);
if (FAILED(hr)) goto EXIT;

// Retrieve a pointer to an IXMLDOMNamedNodeMap interface.
hr = pXMLElement->get_attributes(&pXMLNamedNodeMap);
if (FAILED(hr)) goto EXIT;

// Remove the newly created attribute.
bstrName = "src";
hr = pXMLNamedNodeMap->removeNamedItem(bstrName, &pXMLNode);
if (FAILED(hr)) goto EXIT;

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

Requirements

Header: wmsserver.h.

Library: WMSServerTypeLib.dll.

Platform: Windows Server 2003 family, Windows Server 2008 family.

See Also

Previous Next