The first error handling routine allows the programmer to define an error callback function that is called when a fatal error is generated by the API or explicitly by the programmers code.
The second routine performs a method for clean termination of the program, shutting down the program and communication with Ansys CFX.
void cfxImportError (callback) void (*callback)(char *errmsg);
Define a user routine to be called before terminating due to
a fatal error. callback
is the application-supplied
function to be called in the case of an error. The callback routine
takes a single argument, errmsg
, which will be
passed by cfxImportFatal
and should be processed
by the callback function as a brief message describing the error that
has occurred. If this function is not called or callback is not specified,
then the normal termination behavior of the mesh import API will be
that the any fatal errors will write the error message to stderr
as well as being sent to CFX.
void cfxImportFatal (errmsg) char *errmsg;
Terminate with an error message, errmsg
. This routine will send the message to CFX, shut down the communication
channel or test file and call the user callback function (if specified
by a call to cfxImportError).
There is no return from this call. The import program will terminate immediately after clean up tasks have been performed.