prg_dl_shobj_last_error_msg_get()
Abstract
Retrieves a list of error messages.
Syntax
prg_dl_shobj_last_error_msg_get()
| Argument | Type | Description |
|---|---|---|
| no arguments |
Return Type
PrgT_List *
Pointer to a list of error messages.
Header
prg_dl.h
Details
After every call to prg_dl_shobj_load() there may be error messages. This function returns a new list of strings with any messages. Many operating systems have an analogous function called last_error().
To use this function:
- Call
prg_dl_shobj_load(). It will attempt to load a shared object. A side effect of calling this function is to clear any old error messages. - Call
prg_dl_shobj_last_error_msg_get(). This creates a new list of strings, which the caller should destroy. Any messages reported by a previous call toprg_dl_shobj_load()will be returned. Ifprg_dl_shobj_load()has never been called, or if there were no error messages the returned list will be empty. If any errors occur withprg_dl_shobj_last_error_msg_get(), the function will return NIL.