globalmapper.LoadLayerList
==========================

.. currentmodule:: globalmapper
.. py:function:: LoadLayerList (str aFilename, GM_LoadFlags_t32 aLoadFlags) -> GM_Error_t32, GM_LayerHandle_t32, unint32

    Loads the given file and returns a pointer to an array containing handles for the opened layers. The number of
    layers in the array is returned as a uint32. Even when only one layer is opened, the handle will still be returned
    in an array. Refer to :doc:`the tutorial page on working with layer handles<../sampleCode/DemoLayers>` for more
    information on how to turn this array pointer into a usable object in Python.

    The layer handles can be used in other calls into the library. Each layer handle must be closed by calling
    :doc:`CloseLayer<globalmapper.CloseLayer>` when the caller is done using it.

    :param str aFilename: the file to load
    :param GM_LoadFlags_t32 aLoadFlags: control flags for loading the file
    :returns: Error Code
    :rtype: GM_Error_t32
    :returns: An array of handles for the loaded layers
    :rtype: GM_LayerHandle_t32
    :returns: The number of layers that were loaded
    :rtype: uint32