Query printers for autoconf info during setup.

chrome/browser/ui/webui/settings/chromeos/cups_printers_handler.h

 // Copyright 2016 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_UI_WEBUI_SETTINGS_CHROMEOS_CUPS_PRINTERS_HANDLER_H_
 #define CHROME_BROWSER_UI_WEBUI_SETTINGS_CHROMEOS_CUPS_PRINTERS_HANDLER_H_
 
 #include <memory>
 #include <string>
 #include <vector>
@@ skipping 31 matching lines @@
   void RegisterMessages() override;
   void OnJavascriptAllowed() override {}
   void OnJavascriptDisallowed() override {}
 
  private:
   // Gets all CUPS printers and return it to WebUI.
   void HandleGetCupsPrintersList(const base::ListValue* args);
   void HandleUpdateCupsPrinter(const base::ListValue* args);
   void HandleRemoveCupsPrinter(const base::ListValue* args);
 
+  // For a CupsPrinterInfo in |args|, retrieves the relevant PrinterInfo object
+  // using an IPP call to the printer.
+  void HandleGetPrinterInfo(const base::ListValue* args);
+
+  // Handles the callback for HandleGetPrinterInfo.  |callback_id| is the

[stevenjb, 2017/06/08 15:58:28]

nit: We generally avoid using two spaces between sentences in comments.

[skau, 2017/06/08 22:11:26]

Done.

+  // identifier to resolve the correct Promise.  |success| indicates if the
+  // query was successful.  |make| is the detected printer manufacturer.
+  // |model| is the detected model. |ipp_everywhere| indicates if configuration
+  // using the CUPS IPP Everywhere driver should be attempted.  If |success| is
+  // false, the values of |make|, |model| and |ipp_everywhere| are not
+  // specified.
+  void OnPrinterInfo(const std::string& callback_id,
+                     bool success,
+                     const std::string& make,
+                     const std::string& model,
+                     bool ipp_everywhere);
+
   void HandleAddCupsPrinter(const base::ListValue* args);
   void OnAddedPrinter(std::unique_ptr<Printer> printer,
                       chromeos::PrinterSetupResult result);
   void OnAddPrinterError();
 
   // Get a list of all manufacturers for which we have at least one model of
   // printer supported.  Takes one argument, the callback id for the result.
   // The callback will be invoked with {success: <boolean>, models:
   // <Array<string>>}.
   void HandleGetCupsPrinterManufacturers(const base::ListValue* args);
@@ skipping 47 matching lines @@
 
   base::WeakPtrFactory<CupsPrintersHandler> weak_factory_;
 
   DISALLOW_COPY_AND_ASSIGN(CupsPrintersHandler);
 };
 
 }  // namespace settings
 }  // namespace chromeos
 
 #endif  // CHROME_BROWSER_UI_WEBUI_SETTINGS_CHROMEOS_CUPS_PRINTERS_HANDLER_H_