====== var_GetDataPtr ======

===== Description =====

Retrieve the raw memory handle to the data contained within a ZVAR.

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

<code>void* CExtAPI::var_GetDataPtr(ZVAR hVar);</code>

===== Arguments =====

^ Name ^ Type ^ Comment ^
| hVar | ZVAR | The handle to variable for which the data pointer is to be retrieved. |

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

A null pointer if:
  * The variable is not initialised.
  * The variable is of type VarID_void.
  * An unspecified error occurred.
Otherwise, a valid handle is returned.

===== Comments =====

<note warning>
This function //should not be used//. If you need to set/get variable values, use [[zeolite:functions:var_SetValue]]/[[zeolite:functions:var_GetValue]]. If you need to manipulate data in class variables, use the relevant API functions (e.g. [[zeolite:functions:format_GetExt]]).
</note>