Function: get_recent_err_msg

Description

Obtains and clears the error messages returned by other failed pyacl API calls in the calling thread.

The err_msg_mode configuration item in the acl.init API determines whether to obtain the process- or thread-level error description. The thread-level error description is obtained by default.

Prototype

C Prototype
1
const char *aclGetRecentErrMsg()
Python Function
1
msg = acl.get_recent_err_msg()

Parameters

None

Return Value

Return Value	Description
ret	Int, error code. 0 on success; else, failure.

Restrictions

You are advised to make a separate acl.get_recent_err_msg call on each pyacl API call failure to facilitate troubleshooting.
If acl.get_recent_err_msg has been called for multiple times in a thread, only the error message string returned by the most recent call is valid. Do not use those returned by the previous calls as this will result in unauthorized memory access.
Make a separate acl.get_recent_err_msg call on each pyacl API call failure to avoid error messages from being stacked or lost.

Parent topic: Exception Handling