mmr_context_open()

#include <mm/renderer/renderer.h>
 

mmr_context_t* mmr_context_open(mmr_connection_t *connection,
                                const char *name)

Since:

BlackBerry 10.0.0

Arguments:

connection

An mm-renderer connection handle

name

The context name.

Library:

libmmrndclient (For the qcc command, use the -l mrndclient option to link against this library)

Description:

Open a handle to an existing context. The handle returned by this function is called a secondary handle.

The mm-renderer service allows you to open as many secondary handles as you like. If the context is destroyed or the primary handle is closed, the secondary handles are still valid, but they should be closed; you can pass them to other API calls, but those calls will fail.

To avoid memory leaks, you must close every handle opened with mmr_context_open(), either explicitly by calling one of the following:

or implicitly by terminating the process.

Returns:

A handle on success, or a null pointer on failure (check errno).