__iew_startS() – Start segment

Structures an overlay format program. Used in conjunction with __iew_orderS(). Can be used only when _IEW_BIND intent is specified.

Format

#include <__iew_api.h>
int __iew_startS(_IEWAPIContext *__context,
                           const char *__origin, 
                           _IEWAPIFlags __flags);

Parameters Descriptions

__context

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

__origin

segment origin symbol.

__flags

API flags:

__region - whether or not the segment begins a new region within the program module

Note: Set the flag to 1 to turn the bit on or 0 to turn the bit off.

Returned Value

If successful, __iew_startS() returns 0.

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