ddpi_error_set_errhandler operation

This operation designates the given error-handling callback function as the libddpi error handler.

Prototype

int Ddpi_Handler   ddpi_error_set_errhandler(
    Ddpi_Info      info,
    Ddpi_Handler   errhand,
    Ddpi_Error *   error);

Parameters

info: Input. This input parameter accepts the Ddpi_Info processing object.
errhand: Input. This parameter accepts either the error-handling callback function or NULL.
error: See The libddpi error parameter.

Return values

DW_DLV_OK

This value is returned upon successful release of resources associated with the Ddpi_Info descriptor.

DW_DLV_NO_ENTRY

This value is returned if the value of the error parameter is NULL.

DW_DLV_ERROR

If the value of the error parameter is not NULL, the operation returns the error value without verifying that it is within the valid range. This value is returned if:

info is NULL
An unexpected error occurs while freeing storage