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

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

The local name to write. NULL is not valid.

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

Returns S_OK if no error is generated.

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 (":").

Header: XmlLite.h

Library: XmlLite.lib

IXmlWriter Methods