<!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> const DOMString tagName,<BR> 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>