An error-handling callback function and a pointer to an
error argument (errarg
) can be specified by the program analysis
application during initialization of libddpi
. During initialization
of the Ddpi_Info
object, the callback function is given by
the errhand
parameter. If libddpi
detects
an error and no Ddpi_Error
object is specified in the application,
the error-handling callback function is called.
errarg
pointer
received from the callback function. The callback function is changed by calling
the ddpi_error_set_errhandler
operation. The pointer is changed
by calling the ddpi_error_set_errarg
operation. Ddpi_Error
object
that documents the error. errarg
pointer, which is provided
as a convenience for the program analysis application. The pointer can be
used to pass extra information to the callback function.libddpi
operation
is called, the return values are undefined. The error-handling callback function
might not be called, and the libddpi
operation might abort
execution. Examples of invalid arguments are:libddpi
operation (except where explicitly
permitted)