Share via


WriteQualifiedName

 

Writes out the specified namespace-qualified name by looking up the prefix that is in scope for the specified namespace.

Syntax

  
HRESULT WriteQualifiedName (const WCHAR * pwszLocalName, const WCHAR * pwszNamespaceUri);  

Arguments

pwszLocalName
The local name to write. NULL is not valid.

pwszNamespaceUri
The namespace URI of the name to write. NULL is equivalent to the empty string.

Return Value

Returns S_OK if no error is generated.

Remarks

This method outputs the qualified name given the specified namespace and local name. If the provided namespace is not in scope, then this method returns an error. If the provided namespace is in scope and the namespace has a namespace prefix, then this method writes the qualified name with the prefix. If the namespace provided is the current default namespace, the name does not need a prefix and this method does not produce one.

The WriteQualifiedName method returns an error if pwszLocalName is NULL or the name is not valid according to the Namespaces in XML specification. An example of this is if the name starts with a colon (":").

Requirements

Header: XmlLite.h

Library: XmlLite.lib

See Also

IXmlWriter Methods