__iew_addA() – Add alias

Adds a new alias to the list of aliases for a program, or changes the AMODE of an entry point. Can be used when binding or copying a program.

Format

#include <__iew_api.h>
int __iew_addA(_IEWAPIContext *__context,
                           const char *__aname, const char *__ename,
                           _IEWAnameType __anametype,
                           const char *__amode);

Parameters Descriptions

__context: API context is created and returned by calling __iew_openW() and is used throughout the open session.
__aname: the name of the alias to be added
__ename: existing external symbol in the program to be associated with the alias
__anametype: alias type can be one of the following:
_IEW_ALIAS
_IEW_SYM_LINK
_IEW_PATH
__amode: amode and the values that can be specified for amode are ‘24’, ‘31’, ‘64’, ‘ANY’, and ‘MIN’

Returned Value

If successful, __iew_addA() returns 0.

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