Symbian Developer Library

SYMBIAN OS V6.1 EDITION FOR C++

[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 aTReal32: 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

[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.