Page tree

 

JAVA

FORTRAN

C++

C

 

Link

H5ES_GET_ERR_INFO

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_clearedOUT: 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.0C function introduced in this release.

--- Last Modified: January 12, 2021 | 02:01 PM