IN: Identifier of the error stack to which the error record is to be pushed
If the identifier is H5E_DEFAULT, the error record will be pushed to the current stack.
const char *file
IN: Name of the file in which the error was detected
const char *func
IN: Name of the function in which the error was detected
IN: Line number within the file at which the error was detected
IN: Error class identifier
IN: Major error identifier
IN: Minor error identifier
const char *msg
IN: Error description string
H5E_PUSH2 pushes a new error record onto the error stack specified by estack_id.
The error record contains the error class identifier class_id, the major and minor message identifiers major_id and minor_id, the function name func where the error was detected, the file name file and line number line within that file where the error was detected, and an error description msg.
The major and minor errors must be in the same error class.
The function name, filename, and error description strings must be statically allocated.
msg can be a format control string with additional arguments. This design of appending additional arguments is similar to the system and C functions printf and fprintf.
Returns a non-negative value if successful; otherwise returns a negative value.