isc_print_status()
Go Up to API Function Reference
Builds and displays error messages based on the contents of the InterBase error status vector.
Syntax
ISC_STATUS isc_print_status(ISC_STATUS *status_vector);
| Parameter | Type | Description |
|---|---|---|
|
|
|
Pointer to the error status vector |
Description
isc_print_status() builds all error messages based on the contents of the error status vector, and displays them on the screen. status_vector must be declared in the program as an array of twenty elements.
Example
The following code displays error messages when an error occurs during processing:
#include <ibase.h>
ISC_STATUS status_vector[20];
. . .
if (status_vector[0] == 1 && status_vector[1]) {
isc_print_status(status_vector);
return(1);
}
Return value
isc_print_status() returns the second element of the status vector. Zero indicates success. A nonzero value indicates an error. For InterBase errors, the first element of the status vector is set to 1, and the second element is set to an InterBase error code.
To check for an InterBase error, examine the first two elements of the status vector directly. For more information about examining the status vector, see Handling Error Conditions.