Add major error message to an error class.

Procedure:

H5E_CREATE_MSG(class, msg_type, mesg)

Signature:

<pre><code class="language-c">hid_t H5Ecreate_msg(hid_t class, H5E_type_t msg_type, const char* mesg)</code></pre>

Parameters:
hid_t class    IN: Error class identifier.
H5E_type_t msg_type    IN: The type of the error message. 
Valid values are H5E_MAJOR and H5E_MINOR.
const charmesg    IN: Major error message.

Description:

H5Ecreate_msg adds an error message to an error class defined by client library or application program. The error message can be either major or minor which is indicated by parameter msg_type.

Use H5Eclose_msg to close the message identifier returned by this function.

Returns:

Returns a message identifier on success; otherwise returns a negative value. 

Example:

See Also:

 “Using Identifiers”

History:
Release    C
1.8.0Function introduced in this release.