[Resumption 9/11] Handle filename determination for resumed downloads.

chrome/browser/download/download_target_determiner_delegate.h

 // Copyright 2013 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROME_BROWSER_DOWNLOAD_DOWNLOAD_TARGET_DETERMINER_DELEGATE_H_
 #define CHROME_BROWSER_DOWNLOAD_DOWNLOAD_TARGET_DETERMINER_DELEGATE_H_
 
 #include "base/callback_forward.h"
 
 #include "chrome/browser/download/download_path_reservation_tracker.h"
@@ skipping 54 matching lines @@
   // Notifies extensions of the impending filename determination. |virtual_path|
   // is the current suggested virtual path. The |callback| should be invoked to
   // indicate whether any extensions wish to override the path.
   virtual void NotifyExtensions(content::DownloadItem* download,
                                 const base::FilePath& virtual_path,
                                 const NotifyExtensionsCallback& callback) = 0;
 
   // Reserve |virtual_path|. This is expected to check the following:
   // - Whether |virtual_path| can be written to by the user. If not, the
   //   |virtual_path| can be changed to writeable path if necessary.
-  // - If |conflict_action| is UNIQUIFY then |virtual_path| should be modified
-  //   so that the new path is writeable and unique.
+  // - If |conflict_action| is UNIQUIFY then |virtual_path| should be
+  //   modified so that the new path is writeable and unique. If
+  //   |conflict_action| is PROMPT, then in the event of a conflict,
+  //   |callback| should be invoked with |success| set to |false| in
+  //   order to force a prompt. |virtual_path| may or may not be
+  //   modified in the latter case.
+  // - If |create_directory| is true, then the parent directory of
+  //   |virtual_path| should be created if it doesn't exist.
   //
   // |callback| should be invoked on completion with the results.
   virtual void ReserveVirtualPath(
       content::DownloadItem* download,
       const base::FilePath& virtual_path,
       bool create_directory,
       DownloadPathReservationTracker::FilenameConflictAction conflict_action,
       const ReservedPathCallback& callback) = 0;
 
   // Display a prompt to the user requesting that a download target be chosen.
@@ skipping 15 matching lines @@
   // suggested danger type for the download.
   virtual void CheckDownloadUrl(content::DownloadItem* download,
                                 const base::FilePath& virtual_path,
                                 const CheckDownloadUrlCallback& callback) = 0;
 
  protected:
   virtual ~DownloadTargetDeterminerDelegate();
 };
 
 #endif  // CHROME_BROWSER_DOWNLOAD_DOWNLOAD_TARGET_DETERMINER_DELEGATE_H_