====== zfunc_Execute ======

===== Description =====

Execute a Zeolite extension function and retrieve the return value.

===== Files =====

^ Declaration | ''Zeolite.h'' |
^ Implementation | ''Zeolite.cpp'' |

===== Function prototype =====

<code="C">bool zfunc_Execute(ZFUNC hFunc, ZLIST hArgList, ZVAR* phRval);</code>

===== 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 [[zeolite:classes:CzFunc]] wrapper in preference to the API ''zfunc_'' methods. ''CzFunc'' automates some of the labour in dealing with argument prototype lists and return value handling.