Symbian3/SDK/Source/GUID-24A149FA-B82A-53A2-83E6-4F625D7041D7.dita
changeset 7 51a74ef9ed63
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-24A149FA-B82A-53A2-83E6-4F625D7041D7.dita	Wed Mar 31 11:11:55 2010 +0100
@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
+<!-- This component and the accompanying materials are made available under the terms of the License 
+"Eclipse Public License v1.0" which accompanies this distribution, 
+and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
+<!-- Initial Contributors:
+    Nokia Corporation - initial contribution.
+Contributors: 
+-->
+<!DOCTYPE concept
+  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-24A149FA-B82A-53A2-83E6-4F625D7041D7" xml:lang="en"><title>Error
+codes</title><shortdesc>The errors returned by DBMS functions are mostly documented with
+those functions, but this document summarises some of the more common/general
+errors.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>The Store database makes full use of file store functionality, and any
+errors produced by <codeph>CPermanentFileStore</codeph>, its stream objects
+and particularly the underlying file system may be returned by a DBMS function
+where indicated. Also many of the functions require memory to be dynamically
+allocated, and so can fail with <codeph>KErrNoMemory</codeph>.</p>
+<p>The errors returned by DBMS functions are mostly documented with those
+functions. There are a few general errors which can be returned by most of
+the API to indicate certain states that the database or rowsets have encountered.</p>
+<ul>
+<li id="GUID-27B4049F-3F3D-5B86-89B7-33BE8FEDA6C0"><p><codeph>KErrAccessDenied</codeph> -
+The database cannot mix data definition and data manipulation, or combine
+them in a single transaction. i.e.</p> <ul>
+<li id="GUID-838469A1-5415-53C4-A4ED-03D538AEFC54"><p>A rowset or data manipulation
+transaction is open on the database when attempting data definition or recovery.</p> </li>
+<li id="GUID-B29C8C26-298D-50F4-BAA5-425B46B85A89"><p> A data definition transaction
+is still open when attempting to create a rowset. </p> </li>
+<li id="GUID-91184D4A-1BCD-531F-914C-5756C4F08A2D"><p>Any incremental operation
+is open on the database.</p> </li>
+</ul> <p><codeph>KErrDied</codeph> - A transaction has been aborted, because
+an update or commit failed. In this state, the database and all associated
+rowsets become unusable. In this situation, all rowsets which are currently
+updating or inserting a row must be cancelled, and, if the transaction was
+begun explicitly, it must be rolled back. The database is now ready for use
+again.</p> </li>
+<li id="GUID-DFD729AD-B8EC-5A4A-962D-DBCC87C4C261"><p><codeph>KErrNotReady</codeph> -
+This is returned by all rowsets following a rollback on the database. The
+rowset is invalid and must at least be reset and re-evaluated if necessary,
+but can be closed and re-opened if preferred.</p> </li>
+<li id="GUID-EE40A750-1B31-5F2B-A33E-341F1DD9F2A8"><p><codeph>KErrCorrupt</codeph> -
+This is returned when an attempt is made to use an index which has been damaged
+due to a rollback. Rowsets which were using such an index fail on the first
+attempt to navigate their cursor. The database continues to be operational,
+but must be recovered to regain use of damaged indexes.</p> <p>This can also
+be returned in the unlikely event that corruption is detected in any of the
+streams which make up the database. Such damage cannot have been caused by
+DBMS itself, and cannot be repaired.</p> </li>
+</ul>
+</conbody></concept>
\ No newline at end of file