remoting/host/host_extension.h

   1 // Copyright 2014 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 REMOTING_HOST_HOST_EXTENSION_H_
   6 #define REMOTING_HOST_HOST_EXTENSION_H_
   7
   8 #include <string>
   9
  10 #include "base/memory/scoped_ptr.h"
  11
  12 namespace remoting {
  13
  14 class ClientSession;
  15 class HostExtensionSession;
  16
  17 // Extends |ChromotingHost| with new functionality, and can use extension
  18 // messages to communicate with the client.
  19 class HostExtension {
  20  public:
  21   virtual ~HostExtension() {}
  22
  23   // Returns a space-separated list of capabilities provided by this extension.
  24   // Capabilities may be used to inform the client of the availability of an
  25   // extension. They are merged into the capabilities the host reports to the
  26   // client.
  27   virtual std::string GetCapabilities() = 0;
  28
  29   // Creates an extension session, which can handle extension messages for a
  30   // client session.
  31   // NULL may be returned if |client_session| cannot support this
  32   // extension.
  33   // |client_session| must outlive the resulting |HostExtensionSession|.
  34   virtual scoped_ptr<HostExtensionSession> CreateExtensionSession(
  35       ClientSession* client_session) = 0;
  36 };
  37
  38 }  // namespace remoting
  39
  40 #endif  // REMOTING_HOST_HOST_EXTENSION_H_