* @privlevel public
* @privilege %http://tizen.org/privilege/download
*
- * @remarks This function should be called before downloading (see download_start()).
+ * @remarks This function should be called before downloading (see download_start()). \n
+ * The mediastorage privilege http://tizen.org/privilege/mediastorage is needed if @a path is relevant to media storage.\n
+ * The externalstorage privilege http://tizen.org/privilege/externalstorage is needed if @a path is relevant to external storage.
*
* @param[in] download_id The download ID
* @param[in] path The absolute path to the downloaded file \n
* @return @c 0 on success,
* otherwise a negative error value
*
- * @retval #DOWNLOAD_ERROR_NONE Successful
- * @retval #DOWNLOAD_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #DOWNLOAD_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DOWNLOAD_ERROR_INVALID_STATE Invalid state
- * @retval #DOWNLOAD_ERROR_ID_NOT_FOUND No download ID
- * @retval #DOWNLOAD_ERROR_PERMISSION_DENIED Permission denied
- * @retval #DOWNLOAD_ERROR_NOT_SUPPORTED Not supported
+ * @retval #DOWNLOAD_ERROR_NONE Successful
+ * @retval #DOWNLOAD_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DOWNLOAD_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #DOWNLOAD_ERROR_INVALID_STATE Invalid state
+ * @retval #DOWNLOAD_ERROR_INVALID_DESTINATION Invalid destination
+ * @retval #DOWNLOAD_ERROR_ID_NOT_FOUND No download ID
+ * @retval #DOWNLOAD_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #DOWNLOAD_ERROR_NOT_SUPPORTED Not supported
*
* @pre The state must be #DOWNLOAD_STATE_READY, #DOWNLOAD_STATE_FAILED, or #DOWNLOAD_STATE_CANCELED.
*
* @privilege %http://tizen.org/privilege/download
*
* @remarks If the etag value is not present in the download database, it is useless to set the temporary path. \n
- * When resuming download, the data is attached at the end of this temporary file.
+ * When resuming download, the data is attached at the end of this temporary file. \n
+ * The mediastorage privilege http://tizen.org/privilege/mediastorage is needed if @a path is relevant to media storage.\n
+ * The externalstorage privilege http://tizen.org/privilege/externalstorage is needed if @a path is relevant to external storage.
+
*
* @param[in] download_id The download ID
* @param[out] path The full path of temporary file
*
* @retval #DOWNLOAD_ERROR_NONE Successful
* @retval #DOWNLOAD_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DOWNLOAD_ERROR_INVALID_DESTINATION Invalid destination
* @retval #DOWNLOAD_ERROR_ID_NOT_FOUND No download ID
* @retval #DOWNLOAD_ERROR_PERMISSION_DENIED Permission denied
* @retval #DOWNLOAD_ERROR_NOT_SUPPORTED Not supported