__iew_loadW() – Load workmod

Load the program into virtual storage for immediate execution.

Format

#include <__iew_api.h>
int __iew_loadW(_IEWAPIContext *__context,
                             _IEWAPIFlags __flags,
                             void *__eploc, const char *__lname,
                             _IEWExtentListEntry  **__xtlst_entry);
 

Parameters Descriptions

__context
API context is created and returned by calling __iew_openW() and is used throughout the open session.
__flags
API flags:
  • __identify - whether or not the loaded program module is identified to the system
Note: Set the flag to 1 to turn the bit on or 0 to turn the bit off.
__eploc
entry point address.
__lname
name used for identify.
__xtlst_entry
returned buffer – extent list.

Returned Value

If successful, __iew_loadW() returns 0.

If unsuccessful, __iew_loadW() returns nonzero.

Note: The returned value is the same as the code returned by a subsequent __iew_get_return_code().

Utilities Functions

__iew_get_reason_code()
__iew_get_return_code()