Retrieves information about failed operations
Procedure:
H5ES_GET_ERR_INFO (es_id, num_err_info, err_info, num_cleared)
Signature:
herr_t H5ESget_err_info( hid_t es_id, size_t num_err_info, H5ES_err_info_t err_info[], size_t *num_cleared )
Parameters:
hid_t es_id | IN: Identifier of an event set |
size_t num_err_info | IN: The number of elements in err_info array |
H5ES_err_info_t err_info[] | OUT: Array of structures |
size_t *num_cleared | OUT: Number of cleared errors |
Description:
H5ES_GET_ERR_INFO retrieves information about failed operations in an event set specified by es_id
. The strings retrieved for each error info must be released by calling H5_FREE_MEMORY.
Below is the description of the H5ES_err_info_t structure:
typedef struct H5ES_err_info_t {
char * api_name; /* Name of HDF5 API routine called */
char * api_args; /* "Argument string" for arguments to HDF5 API routine called */
char * app_file_name; /* Name of source file where the HDF5 API routine was called */
char * app_func_name; /* Name of function where the HDF5 API routine was called */
unsigned app_line_num; /* Line # of source file where the HDF5 API routine was called */
uint64_t op_ins_count; /* Counter of operation's insertion into event set */
uint64_t op_ins_ts; /* Timestamp for when the operation was inserted into the event set */
hid_t err_stack_id; /* ID for error stack from failed operation */
} H5ES_err_info_t;
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Example:
See Also:
History:
Release | Change |
---|
1.13.0 | C function introduced in this release. |
--- Last Modified: January 12, 2021 | 02:01 PM