<div class="content" name="Insert" uuid="86f098f9-ea34-4c09-8043-4c0940f38331"><p>The IUpdateCollection::Insert (opnum 16) method inserts an
item into the collection.</p><dl>
<dd>
<div><pre> HRESULT Insert(
   [in] LONG index,
   [in] IUpdate* value
 );
</pre></div>
</dd></dl><p><b>index: </b>The zero-based position at which to
insert the item. This can be a position at the end of the list.</p><p><b>value: </b>The item to insert into the list.</p><p><b>Return Values: </b>The method MUST return
information in an <b>HRESULT</b> data structure. The severity bit in the
structure identifies the following conditions:</p><ul><li><p><span><span>  </span></span>If
the severity bit is set to 0, the method completed successfully.</p>
</li><li><p><span><span>  </span></span>If
the severity bit is set to 1, the method failed and encountered a fatal error.</p>
</li></ul><dl>
<dd>
<p>If the collection is read-only,
the server MUST return an error.</p>
</dd>
<dd>
<p>If <b>index</b> is less than
0x00000000 or greater than or equal to the number of items in the collection,
the server MUST return an error.</p>
</dd></dl><p><b>Exceptions Thrown:</b> No exceptions are thrown beyond
those thrown by the underlying RPC protocol <span><a href="../ms-rpce/290c38b1-92fe-4229-91e6-4fc376610c15" data-linktype="relative-path">[MS-RPCE]</a></span>.</p><p>This method SHOULD insert the given item at the given index
in the <b>List</b> ADM element and increment the value of the <b>Count</b> ADM
element.</p></div>