addAttribute Method

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method adds an attribute to the end of the attribute collection.

Syntax

HRESULT addAttribute(
  BSTR strURI,
  BSTR strLocalName,
  BSTR strQName,
  BSTR strType,
  BSTR strValue
);

Parameters

• strURI
  [in] String that contains the namespace Uniform Resource Identifier (URI) or, if the namespace has no URI, an empty string.

• strLocalName
  [in] String that contains the local name of the attribute.

• strQName
  [in] String that contains the XML 1.0 qualified name or, if the qualified name is not available, an empty string.

• strType
  [in] String that represents the attribute type.

• strValue
  [in] String that represents the attribute's default value specified by "#IMPLIED", "#REQUIRED", or "#FIXED", or NULL if none applies. This value string is represented by the attribute's default value, or empty if there is none.

Return Value

• S_OK
  Returned if no errors are reported.

Remarks

To maximize efficiency, the addAttribute method does not check if the attribute is in the list. Therefore, the user application should check for the existence of an attribute before adding it to the bottom of the attribute list.

Requirements

See Also

Reference

IMXAttributes