org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-4D4E5B3E-ABC4-43CA-A7E8-027C46BD1FE6.html
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/><meta name="copyright" content="(C) Copyright 2009"/><meta name="DC.rights.owner" content="(C) Copyright 2009"/><meta name="DC.Type" content="mobileconcept"/><meta name="DC.Title" content="IDataSource.Import()"/><meta name="DC.Relation" scheme="URI" content="GUID-A9024277-4FA2-429D-9C54-A155ED658B32"/><meta name="DC.Relation" scheme="URI" content="GUID-2B13380C-37C8-473F-B0A7-564439312DA3"/><meta name="DC.Relation" scheme="URI" content="GUID-7C69DDA4-16F1-4A8F-BDB2-4CB0015B4E81"/><meta name="DC.Relation" scheme="URI" content="GUID-65AAF569-D347-462B-B59A-9D7CA184AB9C"/><meta name="DC.Relation" scheme="URI" content="GUID-B8845FF1-D7F6-476A-8651-8B9C12D8789F"/><meta name="DC.Format" content="XHTML"/><meta name="DC.Identifier" content="GUID-4D4E5B3E-ABC4-43CA-A7E8-027C46BD1FE6"/><title>IDataSource.Import() </title><script type="text/javascript">
function initPage() {}
</script><link href="../PRODUCT_PLUGIN/book.css" rel="stylesheet" type="text/css"/><link href="css/s60/style.css" rel="stylesheet" type="text/css" media="all"/></head><body onload="initPage();"><div class="body"><div class="contentLeft prTxt"><h1 class="pageHeading" id="GUID-4D4E5B3E-ABC4-43CA-A7E8-027C46BD1FE6"><span>IDataSource.</span>Import()</h1><div>
<p><strong>Description:</strong></p>
<p>The <code>Import</code> method imports a set of landmarks to
a landmark database.</p>
<p>This is a synchronous method.</p>
<p><strong>Syntax:</strong></p>
<pre class="codeblock" id="GUID-5D4972E7-E53A-434C-BA14-DDBEDC09D2BF">result = so.IDataSource.Import(criteria);</pre>
<p><strong>Arguments:</strong></p>
<ul>
<li><p><code>criteria</code>:</p>
<p>This is an object that specifies the set of landmarks to import and
optionally the target database. For more information about the object properties
and how to define them, see section <a href="GUID-387912B8-1FF4-40EE-ABC5-AB50DBF8A137.html#GUID-387912B8-1FF4-40EE-ABC5-AB50DBF8A137">Criteria for importing landmarks</a>.</p>
</li>
</ul>
<p><strong>Return value:</strong></p>
<p>The <code>Import</code> method returns an object that contains
the imported landmarks, an error code, and an error message.</p>
<div class="tablenoborder"><a name="GUID-5CC90140-13F6-4DD0-85AF-A080F9613DE5"><!----></a><table cellpadding="4" cellspacing="0" summary="" id="GUID-5CC90140-13F6-4DD0-85AF-A080F9613DE5" frame="border" border="1" rules="all"><caption><strong>Table: </strong>Return value
properties for Import</caption>
<thead align="left">
<tr class="title "><th class="cellrowborder" valign="top" width="33.33333333333333%" id="d0e42413">
<p>Property</p>
</th><th class="cellrowborder" valign="top" width="33.33333333333333%" id="d0e42418">
<p>Description</p>
</th><th class="cellrowborder" valign="top" width="33.33333333333333%" id="d0e42423">
<p>Value</p>
</th></tr>
</thead>
<tbody>
<tr class="">
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="d0e42413 ">
<p><code>result.ReturnValue</code></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="d0e42418 ">
<p>This is an iterator that contains the imported landmarks. Each object
in the iterator is a <a href="GUID-2B3FD0AF-2552-46AB-83B5-F404506D16EE.html#GUID-2B3FD0AF-2552-46AB-83B5-F404506D16EE">landmark
object</a>, which contains the information for a single landmark.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="d0e42423 "> </td>
</tr>
<tr class="bg ">
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="d0e42413 ">
<p><code>result.ErrorCode</code></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="d0e42418 ">
<p>This is a number that specifies a predefined error code.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="d0e42423 ">
<p>See <a href="GUID-0A215AF3-59F0-4158-842C-0D7B030E5EA4.html#GUID-0A215AF3-59F0-4158-842C-0D7B030E5EA4">Service API error codes</a>.</p>
</td>
</tr>
<tr class="">
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="d0e42413 ">
<p><code>result.ErrorMessage</code></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="d0e42418 ">
<p>This is a text string that describes the error.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="d0e42423 ">
<p>See <a href="GUID-4ECCCBED-DE6D-4366-B037-90E874C4DF5C.html#GUID-4ECCCBED-DE6D-4366-B037-90E874C4DF5C">Landmarks Service API error messages</a>.</p>
</td>
</tr>
</tbody>
</table></div>
<p><strong>Remarks:</strong></p>
<ul>
<li><p>If no landmark database is specified, <code>Import</code> is
performed on the default database. If the default database does not exist,
it is created and set active. The default database is <code>file://c:eposlm.ldb</code>.</p>
</li>
<li><p>For more information about landmarks, landmark categories,
and landmark databases, see the <a href="GUID-D581028C-06ED-422D-866E-AE6C93075084.html#GUID-D581028C-06ED-422D-866E-AE6C93075084">Landmarks
Service overview page</a>.</p></li>
</ul>
<p><strong>Example code:</strong></p>
<p/>
<p>For the complete source of a sample widget
that demonstrates how to use this Service API, see <a href="GUID-11D59F76-EC4C-4297-B262-D5174E826B43.html#GUID-11D59F76-EC4C-4297-B262-D5174E826B43">the
full example</a>.</p>
</div></div></div><div class="footer"><hr/><div class="copy">© Nokia 2009.</div></div></body></html>