IXMLDOMElement::getAttributeNode

  • Article

banner art

Previous Next

IXMLDOMElement::getAttributeNode

The getAttributeNode method retrieves the attribute node.

Syntax

  HRESULT getAttributeNode(
 BSTR bstrName,
 IXMLDOMAttribute** ppAttributeNode
);

Parameters

bstrName

[in] BSTR containing the name of the attribute to be retrieved.

ppAttributeNode

[out] Pointer to a pointer to an IXMLDOMAttribute interface that is returned with the supplied name, or NULL if the named attribute cannot be found on this element. 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 retrieves an IXMLDOMAttribute object named "src" using the getAttributeNode method.

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

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

HRESULT             hr;
CComBSTR            bstrName;
CComVariant         varFile;
CComVariant         varAttValue;

// 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 the newly created attribute and retrieve its
// value.
bstrName = "src";
hr = pXMLElement->getAttributeNode(bstrName, &pXMLAttribute);
if (FAILED(hr)) goto EXIT;
hr = pXMLAttribute->get_value(&varAttValue);
    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