Last modified: 24 May 2009
Name: H5Eset_auto2
Signature:
herr_t H5Eset_auto2( hid_t estack_id, H5E_auto2_t func, void *client_data )
Purpose:
Turns automatic error printing on or off.
Description:
H5Eset_auto2 turns on or off automatic printing of errors for the error stack specified with estack_id. An estack_id value of H5E_DEFAULT indicates the current stack.

When automatic printing is turned on, by the use of a non-null func pointer, any API function which returns an error indication will first call func, passing it client_data as an argument.

When the library is first initialized, the auto printing function is set to H5Eprint2 (cast appropriately) and client_data is the standard error stream pointer, stderr.

Automatic stack traversal is always in the H5E_WALK_DOWNWARD direction.

Automatic error printing is turned off with a H5Eset_auto2 call with a NULL func pointer.

Parameters:
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Fortran90 Interface: h5eset_auto_f
See H5Eset_auto.
History:
Release     C
1.8.0 Function introduced in this release.