add comment
[mono.git] / mcs / class / corlib / System.Security.Principal / WindowsImpersonationContext.cs
1 //
2 // System.Security.Principal.WindowsImpersonationContext
3 //
4 // Authors:
5 //      Gonzalo Paniagua Javier (gonzalo@ximian.com)
6 //      Sebastien Pouliot  (sebastien@ximian.com)
7 //
8 // (C) 2002 Ximian, Inc (http://www.ximian.com)
9 // Copyright (C) 2004-2005 Novell, Inc (http://www.novell.com)
10 //
11 // Permission is hereby granted, free of charge, to any person obtaining
12 // a copy of this software and associated documentation files (the
13 // "Software"), to deal in the Software without restriction, including
14 // without limitation the rights to use, copy, modify, merge, publish,
15 // distribute, sublicense, and/or sell copies of the Software, and to
16 // permit persons to whom the Software is furnished to do so, subject to
17 // the following conditions:
18 // 
19 // The above copyright notice and this permission notice shall be
20 // included in all copies or substantial portions of the Software.
21 // 
22 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
23 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
24 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
25 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
26 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
27 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
28 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
29 //
30
31 using System.Runtime.CompilerServices;
32 using System.Runtime.InteropServices;
33 using System.Security;
34
35 namespace System.Security.Principal {
36
37 #if NET_2_0
38         [ComVisible (true)]
39         public class WindowsImpersonationContext : IDisposable {
40 #else
41         public class WindowsImpersonationContext {
42 #endif
43
44                 private IntPtr _token;
45                 private bool undo;
46
47                 internal WindowsImpersonationContext (IntPtr token)
48                 {
49                         // we get a copy to control it's lifetime
50                         _token = DuplicateToken (token);
51                         if (!SetCurrentToken (token)) {
52                                 throw new SecurityException ("Couldn't impersonate token.");
53                         }
54                         undo = false;
55                 }
56 #if NET_2_0
57                 [ComVisible (false)]
58                 public void Dispose ()
59                 {
60                         if (!undo) {
61                                 Undo ();
62                         }
63                 }
64                 
65                 [ComVisible (false)]
66                 protected virtual void Dispose (bool disposing)
67                 {
68                         if (!undo) {
69                                 Undo ();
70                         }
71                         if (disposing){
72                                 // If we are explicitly disposed, we can avoid finalization.
73                                 GC.SuppressFinalize (this);
74                         }
75                 }
76 #else
77                 ~WindowsImpersonationContext ()
78                 {
79                         if (!undo) {
80                                 Undo ();
81                         }
82                 }
83 #endif
84                 public void Undo ()
85                 {
86                         if (!RevertToSelf ()) {
87                                 CloseToken (_token);
88                                 throw new SecurityException ("Couldn't switch back to original token.");
89                         }
90                         CloseToken (_token);
91                         undo = true;
92                         GC.SuppressFinalize (this);
93                 }
94
95                 // see mono/mono/metadata/security.c for implementation
96
97                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
98                 private extern static bool CloseToken (IntPtr token);
99
100                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
101                 private extern static IntPtr DuplicateToken (IntPtr token);
102
103                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
104                 private extern static bool SetCurrentToken (IntPtr token);
105
106                 [MethodImplAttribute (MethodImplOptions.InternalCall)]
107                 private extern static bool RevertToSelf ();
108         }
109 }