content/public/common/child_process_host_delegate.h

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef CONTENT_PUBLIC_COMMON_CHILD_PROCESS_HOST_DELEGATE_H_
   6 #define CONTENT_PUBLIC_COMMON_CHILD_PROCESS_HOST_DELEGATE_H_
   7
   8 #include <string>
   9
  10 #include "base/process/process.h"
  11 #include "content/common/content_export.h"
  12 #include "ipc/ipc_listener.h"
  13
  14 namespace content {
  15
  16 // Interface that all users of ChildProcessHost need to provide.
  17 class ChildProcessHostDelegate : public IPC::Listener {
  18  public:
  19   ~ChildProcessHostDelegate() override {}
  20
  21   // Delegates return true if it's ok to shut down the child process (which is
  22   // the default return value). The exception is if the host is in the middle of
  23   // sending a request to the process, in which case the other side might think
  24   // it's ok to shutdown, when really it's not.
  25   CONTENT_EXPORT virtual bool CanShutdown();
  26
  27   // Called when the child process unexpected closes the IPC channel. Delegates
  28   // would normally delete the object in this case.
  29   virtual void OnChildDisconnected() {}
  30
  31   // Returns a reference to the child process. This can be called only after
  32   // OnProcessLaunched is called or it will be invalid and may crash.
  33   virtual const base::Process& GetProcess() const = 0;
  34 };
  35
  36 };  // namespace content
  37
  38 #endif  // CONTENT_PUBLIC_COMMON_CHILD_PROCESS_HOST_DELEGATE_H_