2 // System.Runtime.InteropServices.SafeHandle
4 // Copyright (C) 2005 Novell, Inc (http://www.novell.com)
6 // Permission is hereby granted, free of charge, to any person obtaining
7 // a copy of this software and associated documentation files (the
8 // "Software"), to deal in the Software without restriction, including
9 // without limitation the rights to use, copy, modify, merge, publish,
10 // distribute, sublicense, and/or sell copies of the Software, and to
11 // permit persons to whom the Software is furnished to do so, subject to
12 // the following conditions:
14 // The above copyright notice and this permission notice shall be
15 // included in all copies or substantial portions of the Software.
17 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
18 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
19 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
20 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
21 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
22 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
23 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
26 // This code is only API complete, but it lacks the runtime support
27 // for CriticalFinalizerObject and any P/Invoke wrapping that might
31 // http://blogs.msdn.com/cbrumme/archive/2004/02/20/77460.aspx
33 // On implementing SafeHandles:
34 // http://blogs.msdn.com/bclteam/archive/2005/03/15/396335.aspx
37 // The System.Runtime.ConstrainedExecution.ReliabilityContractAttribute has
38 // not been applied to any APIs here yet.
40 // TODO: Although DangerousAddRef has been implemented, I need to
41 // find out whether the runtime performs the P/Invoke if the
42 // handle has been disposed already.
48 using System.Runtime.InteropServices;
49 using System.Runtime.ConstrainedExecution;
50 using System.Threading;
52 namespace System.Runtime.InteropServices
54 public abstract class SafeHandle : CriticalFinalizerObject, IDisposable {
56 // Warning: the offset of handle is mapped inside the runtime
57 // if you move this, you must updated the runtime definition of
60 protected IntPtr handle;
61 IntPtr invalid_handle_value;
65 protected SafeHandle (IntPtr invalidHandleValue, bool ownsHandle)
67 invalid_handle_value = invalidHandleValue;
68 owns_handle = ownsHandle;
75 throw new ObjectDisposedException (GetType ().FullName);
77 int newcount, current;
81 } while (Interlocked.CompareExchange (ref refcount, newcount, current) != current);
83 if (newcount == 0 && owns_handle){
85 handle = invalid_handle_value;
90 // I do not know when we could not be able to increment the
91 // reference count and set success to false. It might just
92 // be a convention used for the following code pattern:
94 // bool release = false
95 // try { x.DangerousAddRef (ref release); ... }
96 // finally { if (release) x.DangerousRelease (); }
98 public void DangerousAddRef (ref bool success)
101 throw new ObjectDisposedException (GetType ().FullName);
103 int newcount, current;
106 newcount = current + 1;
108 if (handle == invalid_handle_value || current == 0){
110 // In MS, calling sf.Close () followed by a call
111 // to P/Invoke with SafeHandles throws this, but
112 // am left wondering: when would "success" be
115 throw new ObjectDisposedException (GetType ().FullName);
117 } while (Interlocked.CompareExchange (ref refcount, newcount, current) != current);
121 public IntPtr DangerousGetHandle ()
124 throw new ObjectDisposedException (GetType ().FullName);
130 public void DangerousRelease ()
133 throw new ObjectDisposedException (GetType ().FullName);
135 int newcount, current;
138 newcount = current-1;
139 } while (Interlocked.CompareExchange (ref refcount, newcount, current) != current);
141 if (newcount == 0 && owns_handle){
143 handle = invalid_handle_value;
147 public virtual void Dispose ()
150 GC.SuppressFinalize (this);
154 // See documentation, this invalidates the handle without
157 public void SetHandleAsInvalid ()
159 handle = invalid_handle_value;
162 protected virtual void Dispose (bool disposing)
168 // The docs say `never call this with disposing=false',
169 // the question is whether:
170 // * The runtime will ever call Dipose(false) for SafeHandles (special runtime case)
171 // * Whether we should just call ReleaseHandle regardless?
176 protected abstract bool ReleaseHandle ();
178 protected void SetHandle (IntPtr handle)
180 this.handle = handle;
183 public bool IsClosed {
185 return refcount == 0;
189 public abstract bool IsInvalid {
197 handle = invalid_handle_value;