|
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__ |