Oracle® C++ Call Interface Programmer's Guide, 11g Release 2 (11.2) Part Number E10764-02 |
|
|
PDF · Mobi · ePub |
The SQLException
class provides information on generated errors, their codes and associated messages.
Table 13-40 Summary of SQLException
Method | Description |
---|---|
|
|
Returns the database error code. |
|
Returns the error message |
|
Returns the error message |
|
Returns the error message |
|
Returns the error message |
|
Returns the error message string for this exception. |
|
Sets the error context. |
|
Returns the error message associated with the |
This is the SQLException
constructor.
Syntax | Description |
---|---|
SQLException(); |
Constructs a NULL SQLException object. |
SQLException( const SQLException &e); |
Constructs an SQLException object as a copy of another SQLException object. |
Parameter | Description |
---|---|
e |
The SQLException to be copied. |
Gets the database error code.
int getErrorCode() const;
Returns the error message string of this SQLException
if it was created with an error message string. Returns NULL
if the SQLException
was created with no error message.
string getMessage() const;
Returns the error message string
of this SQLException
if it was created with an error message string
. Passes the globalization enabled environment. Returns a NULL string
if the SQLException
was created with no error message. The error message is in the character set associated with the environment.
string getNLSMessage( Environment *env) const;
Parameter | Description |
---|---|
env |
The globalization enabled environment. |
Returns the error message UString
of this SQLException
if it was created with an error message UString
. Passes the globalization enabled environment. Returns a NULL UString
if the SQLException
was created with no error message. The error message is in the character set associated with the environment.
UString getNLSUStringMessage( Environment *env) const;
Parameter | Description |
---|---|
env |
The globalization enabled environment. |
Returns the error message UString
of this SQLException
if it was created with an error message UString
. Returns a NULL UString
if the SQLException
was created with no error message. The error message is in the character set associated with the environment.
UString getUStringMessage() const;
Determine if the thrown exception is due to an XA or an SQL error.
Used by C++ XA applications with dynamic registration. Returns an XA error code if the exception is due to XA, or XA_OK
otherwise.
int getXAErrorCode( const string &dbname) const;
Parameter | Description |
---|---|
dbname |
The database name; same as the optional dbname provided in the Open String and used when connecting to the Resource Manager. |
Sets the pointer to the error context.
void setErrorCtx( void *ctx);
Parameter | Description |
---|---|
ctx |
The pointer to the error context. |
Standard C++ compliant function; returns the error message associated with the SQLException
.
const char *what() const throw();