libupnp/docs/dist/html/ixml/ixmlDocument_createElementEx.html
2006-07-06 12:37:29 +00:00

43 lines
1.8 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>EXPORT_SPEC int ixmlDocument_createElementEx</TITLE>
<META NAME="GENERATOR" CONTENT="DOC++ 3.4.10">
</HEAD>
<BODY BGCOLOR="#ffffff">
<H2>EXPORT_SPEC int <A HREF="#DOC.DOCU">ixmlDocument_createElementEx</A></H2><H2>(IXML_Document* doc,<BR>&nbsp; const DOMString tagName,<BR>&nbsp; IXML_Element** rtElement )</H2><BLOCKQUOTE>Creates a new <B>Element</B> node with the given tag name.</BLOCKQUOTE>
<A NAME="DOC.DOCU"></A>
<HR>
<H2>Documentation</H2>
<BLOCKQUOTE>Creates a new <B>Element</B> node with the given tag name. The new
<B>Element</B> node has a <TT>nodeName</TT> of <B>tagName</B> and
the <TT>localName</TT>, <TT>prefix</TT>, and <TT>namespaceURI</TT> set
to <TT>NULL</TT>. To create an <B>Element</B> with a namespace,
see <B>ixmlDocument_createElementNS</B>.
<P>The <B>ixmlDocument_createElementEx</B> API differs from the <B>
ixmlDocument_createElement</B> API in that it returns an error code
describing the reason for failure rather than just <TT>NULL</TT>.
<P></BLOCKQUOTE>
<DL><DT><DT><B>Parameters:</B><DD><B>doc</B> - The owner <B>Document</B> of the new node.
<BR><B>tagName</B> - The tag name of the new <B>Element</B>
node.
<BR><B>rtElement</B> - Pointer to an <B>Element</B> where the new
object will be stored. <BR><DT><B>Returns:</B><DD> [int] An integer representing one of the following:
<UL>
<LI> <TT>IXML_SUCCESS</TT>: The operation completed successfully.
<LI> <TT>IXML_INVALID_PARAMETER</TT>: Either <B>doc</B> or
<B>tagName</B> is <TT>NULL</TT>.
<LI> <TT>IXML_INSUFFICIENT_MEMORY</TT>: Not enough free memory exists
to complete this operation.
</UL>
<BR><DD></DL><P><P><I><A HREF="index.html">Alphabetic index</A></I></P><HR>
<BR>
This page was generated with the help of <A HREF="http://docpp.sourceforge.net">DOC++</A>.
</BODY>
</HTML>