====== zvar_GetSharedVar ======

===== Description =====

Retrieve the ZVAR handle of a shared variable by name.

===== Files =====

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

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

<code="C">ZVAR zvar_GetSharedVar(const char* lpVarName);</code>

===== Arguments =====

^ Name ^ Type ^ Comment ^
| lpVarName | const char* | A pointer to a C-style string naming the variable to be retrieved. |

===== Return value =====

Null if an error occurred or the named variable does not exist, and a non-null ZVAR handle otherwise. 

===== Comments =====

==== Nested list members ====

You can retrieve items in nested lists using the '.' (dot) delimiter. For example, using an //lpVarName// of "list1.list2.list3.varname" will retrieve the variable named //varname// from the list //list3//, which is in //list2//, which is in //list1//, which is in the root of the shared memory.