camera_roll_get_path()

Retrieve the camera roll path.

Synopsis:

#include <camera/camera_api.h>

camera_error_t camera_roll_get_path(camera_handle_t handle,                 
                                    char *pathname,                 
                                    int pathlen)

Since:

BlackBerry 10.0.0

Arguments:

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

pathname: A buffer to receive the NULL-terminated string specifying the path to the camera roll.

pathlen: The size of the pathname buffer. This should be set to CAMERA_ROLL_NAMELEN.

Library:

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

Description:

Use this function to retrieve the camera roll path in which the camera stores photo and video files using camera_roll_open_photo() and camera_roll_open_video(). See also camera_roll_set_path().

Returns:

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