Function : Extension Manager
VARARG_ADDR - Pass elements of a variable argument list by reference.
#include <global.h> <type> VARARG_ADDR( VARARG_PTR aap);
This function is used to pass elements of a variable argument list of an API function in a Extension Manager callback by reference. This function is implemented as a macro.
Platforms that strictly comply to the C standard do not allow passing of variable argument lists by reference using '&' and '*' operators because the standard states that you may get undetermined results. However, you are allowed to pass a variable argument list without these operators. On Linux for zSeries, whenever you pass a variable argument list the contents will always be modified upon returning from the function passing it in as a parameter (assuming some function below accesses the list.) For these types of platforms, the following macros are defined to just pass the list without using the '&' operator. All platforms can still use a variable argument list as a pointer by simply using the VARARG_PTR_P type.
typedef VARARG_PTR VARARG_PTR_P;
define VARARG_ADDR(_AAP) _AAP
define VARARG_DEREF(_AAP) _AAP
define VARARG_COPY __va_copy
typedef VARARG_PTR * VARARG_PTR_P;
define VARARG_ADDR(_AAP) &_AAP
define VARARG_DEREF(_AAP) *_AAP
define VARARG_COPY(dest, src) (dest)=(src)
Parameters : Input : aap - Pointer into a variable argument list.
Output : (routine) - The type of element passed by reference.
aap - The address of the variable argument list element.