×
Namespaces

Variants
Actions
(Difference between revisions)

Symbian error codes

From Nokia Developer Wiki
Jump to: navigation, search
hamishwillee (Talk | contribs)
m (Fix links to developer.symbian.com (defunct))
hamishwillee (Talk | contribs)
m (Hamishwillee - Bot update - Add ArticleMetaData)
Line 1: Line 1:
 +
{{ArticleMetaData <!-- v1.2 -->
 +
|sourcecode= <!-- Link to example source code e.g. [[Media:The Code Example ZIP.zip]] -->
 +
|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
 +
|devices= <!-- Devices tested against - e.g. ''devices=Nokia 6131 NFC, Nokia C7-00'') -->
 +
|sdk= <!-- SDK(s) built and tested against (e.g. [http://linktosdkdownload/ Qt SDK 1.1.4]) -->
 +
|platform= <!-- Compatible platforms - e.g. Symbian^1 and later, Qt 4.6 and later -->
 +
|devicecompatability= <!-- Compatible devices e.g.: All* (must have internal GPS) -->
 +
|dependencies= <!-- Any other/external dependencies e.g.: Google Maps Api v1.0 -->
 +
|signing= <!-- Signing requirements - empty or one of: Self-Signed, DevCert, Manufacturer -->
 +
|capabilities= <!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. -->
 +
|keywords= <!-- APIs, classes and methods (e.g. QSystemScreenSaver, QList, CBase -->
 +
|language= <!-- Language category code for non-English topics - e.g. Lang-Chinese -->
 +
|translated-by= <!-- [[User:XXXX]] -->
 +
|translated-from-title= <!-- Title only -->
 +
|translated-from-id= <!-- Id of translated revision -->
 +
|review-by= <!-- After re-review: [[User:username]] -->
 +
|review-timestamp= <!-- After re-review: YYYYMMDD -->
 +
|update-by= <!-- After significant update: [[User:username]]-->
 +
|update-timestamp= <!-- After significant update: YYYYMMDD -->
 +
|creationdate= 20070328
 +
|author= [[User:Tote b5]]
 +
}}
 
[[Category:Debugging]][[Category:Symbian C++]]
 
[[Category:Debugging]][[Category:Symbian C++]]
<div align="right">'''Reviewer Approved''' &nbsp;&nbsp; [[File:Thumbs_up_icon_sm.jpg|31x38px]]</div>
+
<div align="right">'''Reviewer Approved''' &nbsp;&nbsp; [[File:Thumbs up icon sm.jpg|31x38px]]</div>
Global error codes from <tt>e32err.h</tt>. Note that each constant is defined as an integer like this:
+
Global error codes from {{Icode|e32err.h}}. Note that each constant is defined as an integer like this:
  
 
<code>const TInt KErrNone;</code>
 
<code>const TInt KErrNone;</code>
Line 81: Line 103:
 
| KErrEof || align = "center" | -25 || Indicates that end of file has been reached.
 
| KErrEof || align = "center" | -25 || Indicates that end of file has been reached.
  
Note that <tt>RFile::Read()</tt> is a higher-level interface. When the end of the file is reached, it returns zero bytes in the destination descriptor, and a ''KErrNone'' return value. KErrEof is not used for this purpose; other error conditions are returned only if some other error condition was indicated on the file.
+
Note that {{Icode|RFile::Read()}} is a higher-level interface. When the end of the file is reached, it returns zero bytes in the destination descriptor, and a ''KErrNone'' return value. KErrEof is not used for this purpose; other error conditions are returned only if some other error condition was indicated on the file.
 
|-
 
|-
 
| KErrDiskFull || align = "center" | -26 || A write operation cannot complete, because the disk is full.
 
| KErrDiskFull || align = "center" | -26 || A write operation cannot complete, because the disk is full.

Revision as of 10:56, 23 July 2012

Article Metadata
Article
Created: tote_b5 (28 Mar 2007)
Last edited: hamishwillee (23 Jul 2012)
Reviewer Approved    Thumbs up icon sm.jpg

Global error codes from e32err.h. Note that each constant is defined as an integer like this:

const TInt KErrNone;

Also note that all of these codes indicate an error in the environment, or in user input from which a program may recover.

Error code Value Description
KErrNone 0 No error.
KErrNotFound -1 Item not found.
KErrGeneral -2 An error that has no specific categorisation.
KErrCancel -3 Indicates an operation that has been cancelled.
KErrNoMemory -4 An attempt to allocate memory has failed.
KErrNotSupported -5 Some functionality is not supported in a given context.

There may be many reasons for this; for example, a device may not support some specific behaviour.

KErrArgument -6 An argument is out of range.

A system wide error code indicates an error in the environment, or in user input from which a program may recover.

KErrTotalLossOfPrecision -7 A calculation has lost precision.

This error arises when converting from an internal 96-bit real representation to a TReal32; the exponent of the internal representation is so small that the 32-bit real cannot contain it.

KErrBadHandle -8 An invalid handle has been passed.

A function involving a resource owned by a server or the kernel has specified an invalid handle.

KErrOverflow -9 Indicates an overflow in some operation.

In the context of mathematical or time/date functions, indicates a calculation that has produced arithmetic overflow exceeding the bounds allowed by the representation.

In the context of data transfer, indicates that a buffer has over-filled without being emptied soon enough.

KErrUnderflow -10 Indicates an underflow in some operation.

In the context of mathematical or time/date functions, indicates a calculation that has produced a result smaller than the smallest magnitude of a finite number allowed by the representation.

In the context of data transfer, indicates that a buffer was under-filled when data was required.

KErrAlreadyExists -11 An object already exists.

An object of some name/type is to be created, but an object of that name/type already exists.

KErrPathNotFound -12 In the context of file operations, a path was not found.
KErrDied -13 A handle refers to a thread that has died.
KErrInUse -14 A requested resource is already in exclusive use.
KErrServerTerminated -15 Client/server send/receive operation cannot run, because the server has terminated.
KErrServerBusy -16 A client/server send/receive operation cannot run, because the server is busy handling another request.
KErrCompletion -17 Indicates that an operation is complete, successfully or otherwise.

This code may be used to indicate that some follow on operation can take place. It does not necessarily indicate an error condition.

KErrNotReady -18 Indicates that a device required by an i/o operation is not ready to start operations.

A common reason for returning this code is because a device has not been initialised, or has no power.

KErrUnknown -19 A device is of unknown type.
KErrCorrupt -20 Indicates that some media is not formatted properly, or links between sections of it have been corrupted.
KErrAccessDenied -21 Access to a file or device is denied, because the permissions on the file do not allow the requested operation to be performed or the device is in use.
KErrLocked -22 An operation cannot be performed, because the part of the file to be read or written is locked.
KErrWrite -23 During a file write operation, not all the data could be written.
KErrDisMounted -24 A volume which was to be used for a file system operation has been dismounted.
KErrEof -25 Indicates that end of file has been reached.

Note that RFile::Read() is a higher-level interface. When the end of the file is reached, it returns zero bytes in the destination descriptor, and a KErrNone return value. KErrEof is not used for this purpose; other error conditions are returned only if some other error condition was indicated on the file.

KErrDiskFull -26 A write operation cannot complete, because the disk is full.
KErrBadDriver -27 A driver DLL is of the wrong type.
KErrBadName -28 A file name or other object name does not conform to the required syntax.
KErrCommsLineFail -29 A communication line has failed.
KErrCommsFrame -30 A frame error has occurred in a communications operation.
KErrCommsOverrun -31 An overrun has been detected by a communications driver.
KErrCommsParity -32 A parity error has occurred in communications.
KErrTimedOut -33 An operation has timed out.
KErrCouldNotConnect -34 A session could not connect.
KErrCouldNotDisconnect -35 A session could not disconnect.
KErrDisconnected -36 A function could not be executed because the required session was disconnected.
KErrBadLibraryEntryPoint -37 A library entry point was not of the required type.
KErrBadDescriptor -38 A non-descriptor parameter was passed by a client interface, when a server expected a descriptor.
KErrAbort -39 An operation has been aborted.
KErrTooBig -40 A number was too big.
KErrDivideByZero -41 A divide-by-zero operation has been attempted.
KErrBadPower -42 Insufficient power was available to complete an operation.
KErrDirFull -43 An operation on a directory has failed.
KErrHardwareNotAvailable -44 An operation cannot be performed because the necessary hardware is not available.
KErrSessionClosed -45 The completion status when an outstanding client/server message is completed because a shared session has been closed.
KErrPermissionDenied -46 An operation cannot be performed due to a potential security violation.
KErrExtensionNotSupported -47 A requested extension function is not supported by the object concerned.
KErrCommsBreak -48 A break has occurred in a communications operation.
89 page views in the last 30 days.