====== zeofunc_Execute2 ======
===== Description =====
Execute a Zeolite extension function and retrieve the return value.
===== Function prototype =====
bool CExtAPI::zeofunc_Execute2(ZFUNC hFunc, ZLIST hArgList, ZVAR* phRval);
===== Arguments =====
^ Name ^ Type ^ Comment ^
| hFunc | ZFUNC | A handle to the extension function to be executed. |
| hArgList | ZLIST | A handle to the argument list to be passed to the function. |
| phRval | ZVAR* | A handle to a caller-provided, initialised variable handle to contain the return value. |
===== Return value =====
False if an error occurred, and true otherwise.
===== Comments =====
==== Use CzFunc wrapper ====
It is //strongly// recommended that developers use the CzFunc wrapper in preference to the API zeofunc_ methods. CzFunc automates some of the labour in dealing with argument prototype lists and return value handling.
==== Thread safety ====
zeofunc_Execute2 is a threadsafe version of [[zeolite:functions:zeofunc_Execute]], which used a common return variable for all function calls, including parallel calls from different threads. zeofunc_Execute2 should alwyas be used in preference to zeofunc_Execute.