====== zproj_GetOrCreateMap ======

===== Description =====

Retrieve a handle to a map layer in the application's project. If the map layer is not found in the project, the map layer is created. 

===== Files =====

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

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

<code="C">ZMAP zproj_GetOrCreateMap(const char* lpMapName);</code>

===== Arguments =====

^ Name ^ Type ^ Comment ^
|  //lpMapName//  |  const char*  | A handle to a C-style string containing the name of the map to be retrieved or created. |

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

Null if an error occurred, and a valid non-null ''ZMAP'' handle otherwise.

===== Comments =====

This function first calls [[zeolite:functions:zproj_GetMap]], and if that fails, calls [[zeolite:functions:zproj_CreateMap]]. Please refer to the reference pages for those functions for more information.