navigator_extend_timeout()

#include <bps/navigator.h>
 

BPS_API int navigator_extend_timeout(int extension,
                                     char **err)

Since:

BlackBerry 10.0.0

Arguments:

extension

The total time in milliseconds that the application expects to need before it can create its application window.

err

If this function fails, and if err is not null, it will be set to a short description of the error. The caller must free this buffer using bps_free().

Library:

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

Description:

The navigator_extend_timeout() function sends a navigator extendTimeout request to extend the time allowed for the application to create its application window at application start. Normally, the application gets 30 seconds to create its application window. If the application is unable to create windows in this time frame due to initialization or loading issues, it must request an extension to the normal timeout, otherwise it will be terminated.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE upon failure with a short description of the error in err.