Function: get_recent_err_msg

const char *aclGetRecentErrMsg()

msg = acl.get_recent_err_msg()

Obtains and clears the error messages returned by other failure pyACL API calls in the calling thread.

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

None

msg: str, error description.

If multiple error messages are obtained, the latest error message is displayed on the top.

Failure: None

• 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.