camera_roll_set_path()

Set the camera roll path.

Synopsis:

#include <camera/camera_api.h>
 
camera_error_t camera_roll_set_path(camera_handle_t handle,                 
                                    char *pathname)

Since:

BlackBerry 10.0.0

Arguments:

handle

The handle returned by a call to the camera_open() function.

pathname

The absolute path to the new camera roll directory as a NULL-terminated string.

Library:

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

Description:

Use this function to change the directory that the camera uses to create photo and video files when you call camera_roll_open_photo() or camera_roll_open_video(). The value you set for the pathname argument must a NULL-terminated string and must not be larger than CAMERA_ROLL_NAMELEN. The path you select must be a directory which your application has write access to.

Returns:

CAMERA_EOK when the function successfully completes, otherwise another camera_error_t value that provides the reason that the call failed.