Class: TSQLAbnormalError

Declaration: SQLExceptions.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

TSQLException

Inherited By:

None.

Purpose:

This class defines the concrete exceptions that can be thrown by the Record Source framework as a result of unexpected conditions, such as a communications disruption caused by a power outage at an offsite RDBMS.

Instantiation:

Allocate on the heap or the stack.

Deriving Classes:

None.

Concurrency:

Not multithread safe.

Resource Use:

No special requirements.

Other Considerations:

None.

Member Function: TSQLAbnormalError::TSQLAbnormalError

TSQLAbnormalError (EReason err =kOther, const TText & details =TStandardText :: GetEmptyText ())
TSQLAbnormalError (const TSQLAbnormalError &)

Interface Category:

API.

Purpose:

Constructs an exception with the specified reason.
Copy constructor.

Calling Context:

Called to instantiate and initialize an object.
Called to copy an object.

Parameters:

EReason err =kOther -The exception to use in initializing this object.
const TText & details =TStandardText :: GetEmptyText () -The text describing the exception.
const TSQLAbnormalError & -The exception to copy.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TSQLAbnormalError::~TSQLAbnormalError

virtual ~ TSQLAbnormalError ()

Interface Category:

API.

Purpose:

Destructor.

Calling Context:

Called to destroy an object.

Parameters:

Takes no parameters.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TSQLAbnormalError::operator=

TSQLAbnormalError & operator =(const TSQLAbnormalError &)

Interface Category:

API.

Purpose:

Assignment operator.

Calling Context:

Called when an object is assigned to another compatible object.

Parameters:

const TSQLAbnormalError & -The exception to be copied.

Return Value:

A non-const reference to the left-hand side object.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TSQLAbnormalError::GetReason

EReason GetReason () const

Interface Category:

API.

Purpose:

Returns the reason for instantiating and throwing the exception.

Calling Context:

Call this function directly.

Parameters:

Takes no parameters.

Return Value:

The enumerated value of the exception.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TSQLAbnormalError::Throw

virtual void Throw () const

Interface Category:

API.

Purpose:

Throws this exception.

Calling Context:

Call this function directly.

Parameters:

Takes no parameters.

Return Value:

None.

Exceptions:

Throws its associated exception.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Click the icon to mail questions or corrections about this material to Taligent personnel.