Symbian
 Developer Library

DEVELOPER LIBRARY

[Index] [Glossary] [Previous] [Next]



Location: e32std.h

System wide error codes

Support

Supported from 5.0

Description

Error codes are used to report errors from which a program may recover. They indicate an error in the environment or user input (such as insufficient memory, an argument out of range, or a non-connected communication link). Recovery action varies; often, it is to abandon the operation that was being performed.


KErrNone

const TInt KErrNone

Description

No error.

[Top]


KErrNotFound

const TInt KErrNotFound

Description

Item not found.

[Top]


KErrGeneral

const TInt KErrGeneral

Description

An error which has not been categorised.

[Top]


KErrCancel

const TInt KErrCancel

Description

Produced when an operation is cancelled.

[Top]


KErrNoMemory

const TInt KErrNoMemory

Description

A memory allocation failed.

[Top]


KErrNotSupported

const TInt KErrNotSupported

Description

A function is not supported in a given context: for instance, because the device involved does not by its nature support a function or, in rare cases, because an API has been designed but not yet written.

[Top]


KErrArgument

const TInt KErrArgument

Description

An argument is out of range.

[Top]


KErrTotalLossOfPrecision

const TInt KErrTotalLossOfPrecision

Description

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.

[Top]


KErrBadHandle

const TInt KErrBadHandle

Description

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

[Top]


KErrOverflow

const TInt KErrOverflow

Description

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

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

[Top]


KErrUnderflow

const TInt KErrUnderflow

Description

In the context of mathematical or time/date functions, indicates a calculation 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.

[Top]


KErrAlreadyExists

const TInt KErrAlreadyExists

Description

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

[Top]


KErrPathNotFound

const TInt KErrPathNotFound

Description

In the context of file operations, the path was not found.

[Top]


KErrDied

const TInt KErrDied

Description

A handle refers to a thread which has died.

[Top]


KErrInUse

const TInt KErrInUse

Description

A requested resource is already in use by another thread (which is using it exclusively).

[Top]


KErrServerTerminated

const TInt KErrServerTerminated

Description

A client/server send-receive operation cannot execute, because the server has terminated.

[Top]


KErrServerBusy

const TInt KErrServerBusy

Description

A client/server send-receive operation cannot execute, because the server is busy handling another request.

The send-receive tries to send the message ten times, at intervals of 200ms. This error code is returned if this process fails. It is usually an indication of a server which is failing to complete its servicing of requests.

[Top]


KErrCompletion

const TInt KErrCompletion

Description

Indicates that an operation is complete, successfully or otherwise. It may be used to indicate that some follow on operation can take place.

This is not necessarily an error condition.

[Top]


KErrNotReady

const TInt KErrNotReady

Description

A device required by an i/o operation is not ready to start operations, usually because it has not initialised, or has no power.

[Top]


KErrUnknown

const TInt KErrUnknown

Description

A device is of unknown type.

[Top]


KErrCorrupt

const TInt KErrCorrupt

Description

The media is not formatted properly, or links between sections of it have been corrupted.

[Top]


KErrAccessDenied

const TInt KErrAccessDenied

Description

Access to a file was denied, because the permissions on the file do not allow the requested operation to be performed.

[Top]


KErrLocked

const TInt KErrLocked

Description

The operation cannot be performed, because the part of the file to be read or written is locked.

[Top]


KErrWrite

const TInt KErrWrite

Description

During a file write operation, not all the data could be written.

[Top]


KErrDisMounted

const TInt KErrDisMounted

Description

A volume which was to be used for a file system operation has been dismounted.

[Top]


KErrEof

const TInt KErrEof

Description

End of file has been reached.

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

[Top]


KErrDiskFull

const TInt KErrDiskFull

Description

A write operation could not complete, because the disk was full.

[Top]


KErrBadDriver

const TInt KErrBadDriver

Description

A driver DLL was of the wrong type.

[Top]


KErrBadName

const TInt KErrBadName

Description

A file name or other object name did not conform with the required syntax.

[Top]


KErrCommsLineFail

const TInt KErrCommsLineFail

Description

The communication line failed.

[Top]


KErrCommsFrame

const TInt KErrCommsFrame

Description

A frame error occurred in a communications operation.

[Top]


KErrCommsOverrun

const TInt KErrCommsOverrun

Description

An overrun was detected by a communications driver.

[Top]


KErrCommsParity

const TInt KErrCommsParity

Description

A parity error occurred in communications.

[Top]


KErrTimedOut

const TInt KErrTimedOut

Description

An operation timed out.

[Top]


KErrCouldNotConnect

const TInt KErrCouldNotConnect

Description

A session could not connect.

[Top]


KErrCouldNotDisconnect

const TInt KErrCouldNotDisconnect

Description

A session could not disconnect.

[Top]


KErrDisconnected

const TInt KErrDisconnected

Description

A function could not be executed because the required session was disconnected.

[Top]


KErrBadLibraryEntryPoint

const TInt KErrBadLibraryEntryPoint

Description

A library entry point was not of the required type.

[Top]


KErrBadDescriptor

const TInt KErrBadDescriptor

Description

A non-descriptor parameter was passed to by a client interface, where the server expected one.

[Top]


KErrAbort

const TInt KErrAbort

Description

An operation was aborted.

[Top]


KErrTooBig

const TInt KErrTooBig

Description

A number was too big.

[Top]


KErrDivideByZero

const TInt KErrDivideByZero

Description

A divide-by-zero operation was attempted.

[Top]


KErrBadPower

const TInt KErrBadPower

Description

Insufficient power was available to complete an operation.

[Top]


KErrDirFull

const TInt KErrDirFull

Description

An operation on a directory has failed.

[Top]


KErrHardwareNotAvailable

const TInt KErrHardwareNotAvailable

Description

An operation cannot be performed because the necessary hardware is not available.