setAttribute Method (Windows CE 5.0)

Send Feedback

Sets the value of the named attribute.

[Script]

Script Syntax

oXMLDOMElement.setAttribute(name, value);

Script Parameters

  • name
    String specifying the name of the attribute. If the attribute with that name already exists, its value is changed. If the attribute with that name does not exist, it is created.
  • value
    Variant that supplies the value for the named attribute.

Script Return Value

None.

[C/C++]

C/C++ Syntax

HRESULT setAttribute(BSTRname,VARIANTvalue);

C/C++ Parameters

  • name
    [in] Name of the attribute. If an attribute with that name already exists, its value is changed. If an attribute with that name does not exist, it is created.
  • value
    [in] Value for the named attribute.

C/C++ Return Values

  • S_OK
    Value returned if successful.
  • E_FAIL
    Value returned if an error occurs.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Msxml2.h, Msxml2.idl.
Link Library: Uuid.lib.

General Remarks

If an attribute with the supplied name already exists, this method changes its value to the supplied value parameter. The supplied string is not parsed, so any markup, such as syntax meant to be recognized as an entity reference, is treated as literal text and must be appropriately escaped by the implementation when it is written out.

To assign an attribute value that contains entity references, the user must create IXMLDOMAttribute plus any IXMLDOMText and IXMLDOMEntityReference objects, build the appropriate subtree, and call the setAttributeNode. method

This method applies to the following objects and interfaces:

IXMLDOMAttribute, IXMLDOMElement, IXMLDOMText, and IXMLDOMEntityReference.

See Also

setAttributeNode Method

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.