load_menu

template<class character>
handle load_menu(handle module,
                 const character* name)

This function loads a menu from a given module.

Parameters

handle module

The handle of the executable module containing the menu resource.

const character* name

The resource identity of the menu or a pointer to the name of the menu resource to be loaded.

Return

handle

null	The call failed.
Other	The handle of the new menu.

Notes

An error results when the resource is not found.

When no longer required, the menu may be destroyed via the function destroy_menu.