__iew_alterW() – Alter workmod

Changes or deletes symbols or sections, or adds patch space to a control section. Can be used only when _IEW_BIND intent was specified.

Format

#include <__iew_api.h>
int __iew_alterW(_IEWAPIContext *__context,
                             _IEWAltType __alttype, _IEWAltMode __altmode,
                             const char *__oldname, const char *__newname,
                             unsigned int *__count,
                             const char *__class);

Parameters Descriptions

__context

API context is created and returned by calling __iew_openW() and is used throughout the open session.

__alttype

alter type can be one of the following:

_IEW_ALT_CHANGE
changes an external symbol of any ESD type from old name to new name
_IEW_ALT_DELETE
deletes an external symbol in the target modules
_IEW_ALT_EXPAND
expands the length of the text of a section
_IEW_ALT_REPLACE
deletes a symbol (old name), and changse any references to that symbol to a new name

__altmode

alter mode can be one of the following:

_IEW_ALT_NEXT
applies only to what will be in the next module to be included into the workmod
_IEW_ALT_IMMED
applies to what is already in the workmod

__oldname

the old name

__newname

the new name

__count

the number of bytes

__class

the class name

Returned Value

If successful, __iew_alterW() returns 0.

If unsuccessful, __iew_alterW() 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()