mmr_error_info_t

The mm-renderer error information.

Synopsis:

#include <mm/renderer/types.h>
 
typedef struct mmr_error_info  mmr_error_info_t;

Since:

BlackBerry 10.0.0

Library:

libmmrndclient (For the qcc command, use the -l mrndclient option to link against this library)

Description:

The structure mmr_error_info_t contains error information generated by mm-renderer functions. Use the function mmr_error_info() to retrieve error information for a particular context and function call.

This multifield structure allows plugins to return protocol- or API-specific error information in addition to the MMR error code. The extra_type string is a tag that specifies how to interpret the extra_value and extra_text fields.

The values of extra_type currently supported are:

  • an empty string (""): extra_value is set to 0, and the extra_text is usually empty, but possibly contains some descriptive text.
  • "errno": extra_value is set to an errno value, and extra_text is usually the result of strerror(extra_value), but may contain something more descriptive.
  • "mmf": extra_value is an MMF-specific error code (which is not a valid errno), and extra_text is usually empty, but possibly contains something more descriptive.
  • "http": extra_value is an HTTP response code, and extra_text is an HTTP server response.
  • "libcurl": extra_value is a libcurl error code (but not CURLE_HTTP_RETURNED_ERROR), and extra_text is the corresponding libcurl error message.