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. 33namespace sandbox { 34 35class 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