pupnp (libupnp) snapshot from SourceForge: git clone git://pupnp.git.sourceforge...
[igd2-for-linux:pandonghui1211s-igd2-for-linux.git] / pupnp_branch-1.6.x / docs / dist / html / ixml / ixmlDocument_createElementEx.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2
3 <HTML>
4 <HEAD>
5    <TITLE>EXPORT_SPEC int ixmlDocument_createElementEx</TITLE>
6    <META NAME="GENERATOR" CONTENT="DOC++ 3.4.10">
7 </HEAD>
8 <BODY BGCOLOR="#ffffff">
9
10 <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>
11
12 <A NAME="DOC.DOCU"></A>
13 <HR>
14 <H2>Documentation</H2>
15 <BLOCKQUOTE>Creates a new <B>Element</B> node with the given tag name.  The new
16 <B>Element</B> node has a <TT>nodeName</TT> of <B>tagName</B> and
17 the <TT>localName</TT>, <TT>prefix</TT>, and <TT>namespaceURI</TT> set 
18 to <TT>NULL</TT>.  To create an <B>Element</B> with a namespace, 
19 see <B>ixmlDocument_createElementNS</B>.
20
21 <P>The <B>ixmlDocument_createElementEx</B> API differs from the <B>
22 ixmlDocument_createElement</B> API in that it returns an error code
23 describing the reason for failure rather than just <TT>NULL</TT>.
24
25 <P></BLOCKQUOTE>
26 <DL><DT><DT><B>Parameters:</B><DD><B>doc</B> -   The owner <B>Document</B> of the new node. 
27 <BR><B>tagName</B> -   The tag name of the new <B>Element</B> 
28 node. 
29 <BR><B>rtElement</B> -   Pointer to an <B>Element</B> where the new 
30 object will be stored. <BR><DT><B>Returns:</B><DD>  [int] An integer representing one of the following:
31 <UL>
32 <LI> <TT>IXML_SUCCESS</TT>: The operation completed successfully.
33 <LI> <TT>IXML_INVALID_PARAMETER</TT>: Either <B>doc</B> or 
34 <B>tagName</B> is <TT>NULL</TT>.
35 <LI> <TT>IXML_INSUFFICIENT_MEMORY</TT>: Not enough free memory exists 
36 to complete this operation.
37 </UL>
38 <BR><DD></DL><P><P><I><A HREF="index.html">Alphabetic index</A></I></P><HR>
39 <BR>
40 This page was generated with the help of <A HREF="http://docpp.sourceforge.net">DOC++</A>.
41 </BODY>
42 </HTML>