1 // Copyright (c) 2006-2008 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 SANDBOX_SRC_SANDBOX_FACTORY_H__ 6 #define SANDBOX_SRC_SANDBOX_FACTORY_H__ 7 8 #include "sandbox/win/src/sandbox.h" 9 10 // SandboxFactory is a set of static methods to get access to the broker 11 // or target services object. Only one of the two methods (GetBrokerServices, 12 // GetTargetServices) will return a non-null pointer and that should be used 13 // as the indication that the process is the broker or the target: 14 // 15 // BrokerServices* broker_services = SandboxFactory::GetBrokerServices(); 16 // if (NULL != broker_services) { 17 // //we are the broker, call broker api here 18 // broker_services->Init(); 19 // } else { 20 // TargetServices* target_services = SandboxFactory::GetTargetServices(); 21 // if (NULL != target_services) { 22 // //we are the target, call target api here 23 // target_services->Init(); 24 // } 25 // 26 // The methods in this class are expected to be called from a single thread 27 // 28 // The Sandbox library needs to be linked against the main executable, but 29 // sometimes the API calls are issued from a DLL that loads into the exe 30 // process. These factory methods then need to be called from the main 31 // exe and the interface pointers then can be safely passed to the DLL where 32 // the Sandbox API calls are made. 33 namespace sandbox { 34 35 class SandboxFactory { 36 public: 37 // Returns the Broker API interface, returns NULL if this process is the 38 // target. 39 static BrokerServices* GetBrokerServices(); 40 41 // Returns the Target API interface, returns NULL if this process is the 42 // broker. 43 static TargetServices* GetTargetServices(); 44 private: 45 DISALLOW_IMPLICIT_CONSTRUCTORS(SandboxFactory); 46 }; 47 48 } // namespace sandbox 49 50 #endif // SANDBOX_SRC_SANDBOX_FACTORY_H__ 51