Semaphore.cs source code in C# .NET

                        
Code:
                         / 4.0 / 4.0 / DEVDIV_TFS / Dev10 / Releases / RTMRel / ndp / fx / src / Sys / System / Threading / Semaphore.cs / 1305376 / Semaphore.cs
                        

                        
                            // ==++== 
//
//   Copyright (c) Microsoft Corporation.  All rights reserved.
//
// ==--== 

namespace System.Threading 
{ 
    using System.IO;
    using System.IO.Ports; 
    using Microsoft.Win32;
    using Microsoft.Win32.SafeHandles;
    using System.Runtime.InteropServices;
    using System.Threading; 
    using System.Security.Permissions;
#if !FEATURE_PAL 
    using System.Security.AccessControl; 
#endif
    using System.Runtime.Versioning; 
    using System.Runtime.ConstrainedExecution;


    [HostProtection(Synchronization=true, ExternalThreading=true)] 
    [ComVisibleAttribute(false)]
    public sealed class Semaphore: WaitHandle 
    { 
        private static int MAX_PATH = 260;
        // creates a nameless semaphore object 
        // Win32 only takes maximum count of Int32.MaxValue
        [ResourceExposure(ResourceScope.None)]
        [ResourceConsumption(ResourceScope.Machine, ResourceScope.Machine)]
        public Semaphore(int initialCount, int maximumCount) : this(initialCount,maximumCount,null){} 

        [SecurityPermissionAttribute(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.UnmanagedCode)] 
        [ResourceExposure(ResourceScope.Machine)] 
        [ResourceConsumption(ResourceScope.Machine)]
        public Semaphore(int initialCount, int maximumCount, string name) 
        {
            if (initialCount < 0)
            {
                throw new ArgumentOutOfRangeException("initialCount", SR.GetString(SR.ArgumentOutOfRange_NeedNonNegNumRequired)); 
            }
 
            if (maximumCount < 1) 
            {
                throw new ArgumentOutOfRangeException("maximumCount", SR.GetString(SR.ArgumentOutOfRange_NeedNonNegNumRequired)); 
            }

            if (initialCount > maximumCount)
            { 
                throw new ArgumentException(SR.GetString(SR.Argument_SemaphoreInitialMaximum));
            } 
 
            if(null != name && MAX_PATH < name.Length)
            { 
                throw new ArgumentException(SR.GetString(SR.Argument_WaitHandleNameTooLong));
            }
            SafeWaitHandle   myHandle = SafeNativeMethods.CreateSemaphore(null, initialCount, maximumCount, name);
 
            if (myHandle.IsInvalid)
            { 
                int errorCode = Marshal.GetLastWin32Error(); 

                if(null != name && 0 != name.Length && NativeMethods.ERROR_INVALID_HANDLE == errorCode) 
                    throw new WaitHandleCannotBeOpenedException(SR.GetString(SR.WaitHandleCannotBeOpenedException_InvalidHandle,name));

                InternalResources.WinIOError();
            } 
            this.SafeWaitHandle = myHandle;
        } 
 
        [SecurityPermissionAttribute(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.UnmanagedCode)]
        [ResourceExposure(ResourceScope.Machine)] 
        [ResourceConsumption(ResourceScope.Machine)]
        public Semaphore(int initialCount, int maximumCount, string name, out bool createdNew)
#if !FEATURE_PAL
            : this(initialCount, maximumCount, name, out createdNew, null) 
        {
        } 
 
        [SecurityPermissionAttribute(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.UnmanagedCode)]
        [ResourceExposure(ResourceScope.Machine)] 
        [ResourceConsumption(ResourceScope.Machine)]
        public unsafe Semaphore(int initialCount, int maximumCount, string name, out bool createdNew, SemaphoreSecurity semaphoreSecurity)
#endif
        { 
            if (initialCount < 0)
            { 
                throw new ArgumentOutOfRangeException("initialCount", SR.GetString(SR.ArgumentOutOfRange_NeedNonNegNumRequired)); 
            }
 
            if (maximumCount < 1)
            {
                throw new ArgumentOutOfRangeException("maximumCount", SR.GetString(SR.ArgumentOutOfRange_NeedNonNegNumRequired));
            } 

            if (initialCount > maximumCount) 
            { 
                throw new ArgumentException(SR.GetString(SR.Argument_SemaphoreInitialMaximum));
            } 

            if(null != name && MAX_PATH < name.Length)
            {
                throw new ArgumentException(SR.GetString(SR.Argument_WaitHandleNameTooLong)); 
            }
            SafeWaitHandle   myHandle; 
#if !FEATURE_PAL 
            // For ACL's, get the security descriptor from the SemaphoreSecurity.
            if (semaphoreSecurity != null) { 
                NativeMethods.SECURITY_ATTRIBUTES secAttrs = null;
                secAttrs = new NativeMethods.SECURITY_ATTRIBUTES();
                secAttrs.nLength = (int)Marshal.SizeOf(secAttrs);
                byte[] sd = semaphoreSecurity.GetSecurityDescriptorBinaryForm(); 
                fixed(byte* pSecDescriptor = sd) {
                    secAttrs.lpSecurityDescriptor = new SafeLocalMemHandle((IntPtr) pSecDescriptor, false); 
                    myHandle = SafeNativeMethods.CreateSemaphore(secAttrs, initialCount, maximumCount, name); 
                }
            } 
            else {
#endif
                myHandle = SafeNativeMethods.CreateSemaphore(null, initialCount, maximumCount, name);
#if !FEATURE_PAL 
            }
#endif 
            int errorCode = Marshal.GetLastWin32Error(); 
            if (myHandle.IsInvalid)
            { 
                if(null != name && 0 != name.Length && NativeMethods.ERROR_INVALID_HANDLE == errorCode)
                    throw new WaitHandleCannotBeOpenedException(SR.GetString(SR.WaitHandleCannotBeOpenedException_InvalidHandle,name));
                InternalResources.WinIOError();
            } 
            createdNew = errorCode != NativeMethods.ERROR_ALREADY_EXISTS;
            this.SafeWaitHandle = myHandle; 
        } 

        [ResourceExposure(ResourceScope.Machine)] 
        [ResourceConsumption(ResourceScope.Machine)]
        private Semaphore(SafeWaitHandle handle)
        {
            this.SafeWaitHandle = handle; 
        }
 
        [SecurityPermissionAttribute(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.UnmanagedCode)] 
        [ResourceExposure(ResourceScope.Machine)]
        [ResourceConsumption(ResourceScope.Machine)] 
        public static Semaphore OpenExisting(string name)
        {
#if !FEATURE_PAL
            return OpenExisting(name, SemaphoreRights.Modify | SemaphoreRights.Synchronize); 
        }
 
        [SecurityPermissionAttribute(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.UnmanagedCode)] 
        [ResourceExposure(ResourceScope.Machine)]
        [ResourceConsumption(ResourceScope.Machine)] 
        public static Semaphore OpenExisting(string name, SemaphoreRights rights)
        {
#endif // !FEATURE_PAL
            if (name == null) 
            {
                throw new ArgumentNullException("name"); 
            } 
            if(name.Length  == 0)
            { 
                throw new ArgumentException(SR.GetString(SR.InvalidNullEmptyArgument, "name"), "name");
            }
            if(null != name && MAX_PATH < name.Length)
            { 
                throw new ArgumentException(SR.GetString(SR.Argument_WaitHandleNameTooLong));
            } 
            //Pass false to OpenSemaphore to prevent inheritedHandles 
#if FEATURE_PAL
            SafeWaitHandle myHandle = SafeNativeMethods.OpenSemaphore(Win32Native.SEMAPHORE_MODIFY_STATE | Win32Native.SYNCHRONIZE, false, name); 
#else
            SafeWaitHandle myHandle = SafeNativeMethods.OpenSemaphore((int) rights, false, name);
#endif
 
            if (myHandle.IsInvalid)
            { 
                int errorCode = Marshal.GetLastWin32Error(); 

                if (NativeMethods.ERROR_FILE_NOT_FOUND == errorCode || NativeMethods.ERROR_INVALID_NAME == errorCode) 
                    throw new WaitHandleCannotBeOpenedException();
                if (null != name && 0 != name.Length && NativeMethods.ERROR_INVALID_HANDLE == errorCode)
                    throw new WaitHandleCannotBeOpenedException(SR.GetString(SR.WaitHandleCannotBeOpenedException_InvalidHandle,name));
                //this is for passed through NativeMethods Errors 
                InternalResources.WinIOError();
            } 
            return new Semaphore(myHandle); 
        }
 

        // increase the count on a semaphore, returns previous count
        [ReliabilityContract(Consistency.WillNotCorruptState, Cer.Success)]
        [PrePrepareMethod] 
        public int Release()
        { 
            return Release(1); 
        }
 
        // increase the count on a semaphore, returns previous count
        [ResourceExposure(ResourceScope.None)]
        [ResourceConsumption(ResourceScope.Machine, ResourceScope.Machine)]
        [ReliabilityContract(Consistency.WillNotCorruptState, Cer.Success)] 
        public int Release(int releaseCount)
        { 
            if (releaseCount < 1) 
            {
                throw new ArgumentOutOfRangeException("releaseCount", SR.GetString(SR.ArgumentOutOfRange_NeedNonNegNumRequired)); 
            }
            int previousCount;

            //If ReleaseSempahore returns false when the specified value would cause 
            //   the semaphore's count to exceed the maximum count set when Semaphore was created
            //Non-Zero return 
 
            if (!SafeNativeMethods.ReleaseSemaphore(SafeWaitHandle, releaseCount, out previousCount))
            { 
                throw new SemaphoreFullException();
            }

            return previousCount; 
        }
 
#if !FEATURE_PAL 
        [ResourceExposure(ResourceScope.None)]
        [ResourceConsumption(ResourceScope.Machine, ResourceScope.Machine)] 
        public SemaphoreSecurity GetAccessControl() {
            return new SemaphoreSecurity(SafeWaitHandle, AccessControlSections.Access | AccessControlSections.Owner | AccessControlSections.Group);
        }
 
        [ResourceExposure(ResourceScope.Machine)]
        [ResourceConsumption(ResourceScope.Machine)] 
        public void SetAccessControl(SemaphoreSecurity semaphoreSecurity) { 
            if (semaphoreSecurity == null)
                throw new ArgumentNullException("semaphoreSecurity"); 

            semaphoreSecurity.Persist(SafeWaitHandle);
        }
#endif 
    }
} 
 

// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
// ==++== 
//
//   Copyright (c) Microsoft Corporation.  All rights reserved.
//
// ==--== 

namespace System.Threading 
{ 
    using System.IO;
    using System.IO.Ports; 
    using Microsoft.Win32;
    using Microsoft.Win32.SafeHandles;
    using System.Runtime.InteropServices;
    using System.Threading; 
    using System.Security.Permissions;
#if !FEATURE_PAL 
    using System.Security.AccessControl; 
#endif
    using System.Runtime.Versioning; 
    using System.Runtime.ConstrainedExecution;


    [HostProtection(Synchronization=true, ExternalThreading=true)] 
    [ComVisibleAttribute(false)]
    public sealed class Semaphore: WaitHandle 
    { 
        private static int MAX_PATH = 260;
        // creates a nameless semaphore object 
        // Win32 only takes maximum count of Int32.MaxValue
        [ResourceExposure(ResourceScope.None)]
        [ResourceConsumption(ResourceScope.Machine, ResourceScope.Machine)]
        public Semaphore(int initialCount, int maximumCount) : this(initialCount,maximumCount,null){} 

        [SecurityPermissionAttribute(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.UnmanagedCode)] 
        [ResourceExposure(ResourceScope.Machine)] 
        [ResourceConsumption(ResourceScope.Machine)]
        public Semaphore(int initialCount, int maximumCount, string name) 
        {
            if (initialCount < 0)
            {
                throw new ArgumentOutOfRangeException("initialCount", SR.GetString(SR.ArgumentOutOfRange_NeedNonNegNumRequired)); 
            }
 
            if (maximumCount < 1) 
            {
                throw new ArgumentOutOfRangeException("maximumCount", SR.GetString(SR.ArgumentOutOfRange_NeedNonNegNumRequired)); 
            }

            if (initialCount > maximumCount)
            { 
                throw new ArgumentException(SR.GetString(SR.Argument_SemaphoreInitialMaximum));
            } 
 
            if(null != name && MAX_PATH < name.Length)
            { 
                throw new ArgumentException(SR.GetString(SR.Argument_WaitHandleNameTooLong));
            }
            SafeWaitHandle   myHandle = SafeNativeMethods.CreateSemaphore(null, initialCount, maximumCount, name);
 
            if (myHandle.IsInvalid)
            { 
                int errorCode = Marshal.GetLastWin32Error(); 

                if(null != name && 0 != name.Length && NativeMethods.ERROR_INVALID_HANDLE == errorCode) 
                    throw new WaitHandleCannotBeOpenedException(SR.GetString(SR.WaitHandleCannotBeOpenedException_InvalidHandle,name));

                InternalResources.WinIOError();
            } 
            this.SafeWaitHandle = myHandle;
        } 
 
        [SecurityPermissionAttribute(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.UnmanagedCode)]
        [ResourceExposure(ResourceScope.Machine)] 
        [ResourceConsumption(ResourceScope.Machine)]
        public Semaphore(int initialCount, int maximumCount, string name, out bool createdNew)
#if !FEATURE_PAL
            : this(initialCount, maximumCount, name, out createdNew, null) 
        {
        } 
 
        [SecurityPermissionAttribute(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.UnmanagedCode)]
        [ResourceExposure(ResourceScope.Machine)] 
        [ResourceConsumption(ResourceScope.Machine)]
        public unsafe Semaphore(int initialCount, int maximumCount, string name, out bool createdNew, SemaphoreSecurity semaphoreSecurity)
#endif
        { 
            if (initialCount < 0)
            { 
                throw new ArgumentOutOfRangeException("initialCount", SR.GetString(SR.ArgumentOutOfRange_NeedNonNegNumRequired)); 
            }
 
            if (maximumCount < 1)
            {
                throw new ArgumentOutOfRangeException("maximumCount", SR.GetString(SR.ArgumentOutOfRange_NeedNonNegNumRequired));
            } 

            if (initialCount > maximumCount) 
            { 
                throw new ArgumentException(SR.GetString(SR.Argument_SemaphoreInitialMaximum));
            } 

            if(null != name && MAX_PATH < name.Length)
            {
                throw new ArgumentException(SR.GetString(SR.Argument_WaitHandleNameTooLong)); 
            }
            SafeWaitHandle   myHandle; 
#if !FEATURE_PAL 
            // For ACL's, get the security descriptor from the SemaphoreSecurity.
            if (semaphoreSecurity != null) { 
                NativeMethods.SECURITY_ATTRIBUTES secAttrs = null;
                secAttrs = new NativeMethods.SECURITY_ATTRIBUTES();
                secAttrs.nLength = (int)Marshal.SizeOf(secAttrs);
                byte[] sd = semaphoreSecurity.GetSecurityDescriptorBinaryForm(); 
                fixed(byte* pSecDescriptor = sd) {
                    secAttrs.lpSecurityDescriptor = new SafeLocalMemHandle((IntPtr) pSecDescriptor, false); 
                    myHandle = SafeNativeMethods.CreateSemaphore(secAttrs, initialCount, maximumCount, name); 
                }
            } 
            else {
#endif
                myHandle = SafeNativeMethods.CreateSemaphore(null, initialCount, maximumCount, name);
#if !FEATURE_PAL 
            }
#endif 
            int errorCode = Marshal.GetLastWin32Error(); 
            if (myHandle.IsInvalid)
            { 
                if(null != name && 0 != name.Length && NativeMethods.ERROR_INVALID_HANDLE == errorCode)
                    throw new WaitHandleCannotBeOpenedException(SR.GetString(SR.WaitHandleCannotBeOpenedException_InvalidHandle,name));
                InternalResources.WinIOError();
            } 
            createdNew = errorCode != NativeMethods.ERROR_ALREADY_EXISTS;
            this.SafeWaitHandle = myHandle; 
        } 

        [ResourceExposure(ResourceScope.Machine)] 
        [ResourceConsumption(ResourceScope.Machine)]
        private Semaphore(SafeWaitHandle handle)
        {
            this.SafeWaitHandle = handle; 
        }
 
        [SecurityPermissionAttribute(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.UnmanagedCode)] 
        [ResourceExposure(ResourceScope.Machine)]
        [ResourceConsumption(ResourceScope.Machine)] 
        public static Semaphore OpenExisting(string name)
        {
#if !FEATURE_PAL
            return OpenExisting(name, SemaphoreRights.Modify | SemaphoreRights.Synchronize); 
        }
 
        [SecurityPermissionAttribute(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.UnmanagedCode)] 
        [ResourceExposure(ResourceScope.Machine)]
        [ResourceConsumption(ResourceScope.Machine)] 
        public static Semaphore OpenExisting(string name, SemaphoreRights rights)
        {
#endif // !FEATURE_PAL
            if (name == null) 
            {
                throw new ArgumentNullException("name"); 
            } 
            if(name.Length  == 0)
            { 
                throw new ArgumentException(SR.GetString(SR.InvalidNullEmptyArgument, "name"), "name");
            }
            if(null != name && MAX_PATH < name.Length)
            { 
                throw new ArgumentException(SR.GetString(SR.Argument_WaitHandleNameTooLong));
            } 
            //Pass false to OpenSemaphore to prevent inheritedHandles 
#if FEATURE_PAL
            SafeWaitHandle myHandle = SafeNativeMethods.OpenSemaphore(Win32Native.SEMAPHORE_MODIFY_STATE | Win32Native.SYNCHRONIZE, false, name); 
#else
            SafeWaitHandle myHandle = SafeNativeMethods.OpenSemaphore((int) rights, false, name);
#endif
 
            if (myHandle.IsInvalid)
            { 
                int errorCode = Marshal.GetLastWin32Error(); 

                if (NativeMethods.ERROR_FILE_NOT_FOUND == errorCode || NativeMethods.ERROR_INVALID_NAME == errorCode) 
                    throw new WaitHandleCannotBeOpenedException();
                if (null != name && 0 != name.Length && NativeMethods.ERROR_INVALID_HANDLE == errorCode)
                    throw new WaitHandleCannotBeOpenedException(SR.GetString(SR.WaitHandleCannotBeOpenedException_InvalidHandle,name));
                //this is for passed through NativeMethods Errors 
                InternalResources.WinIOError();
            } 
            return new Semaphore(myHandle); 
        }
 

        // increase the count on a semaphore, returns previous count
        [ReliabilityContract(Consistency.WillNotCorruptState, Cer.Success)]
        [PrePrepareMethod] 
        public int Release()
        { 
            return Release(1); 
        }
 
        // increase the count on a semaphore, returns previous count
        [ResourceExposure(ResourceScope.None)]
        [ResourceConsumption(ResourceScope.Machine, ResourceScope.Machine)]
        [ReliabilityContract(Consistency.WillNotCorruptState, Cer.Success)] 
        public int Release(int releaseCount)
        { 
            if (releaseCount < 1) 
            {
                throw new ArgumentOutOfRangeException("releaseCount", SR.GetString(SR.ArgumentOutOfRange_NeedNonNegNumRequired)); 
            }
            int previousCount;

            //If ReleaseSempahore returns false when the specified value would cause 
            //   the semaphore's count to exceed the maximum count set when Semaphore was created
            //Non-Zero return 
 
            if (!SafeNativeMethods.ReleaseSemaphore(SafeWaitHandle, releaseCount, out previousCount))
            { 
                throw new SemaphoreFullException();
            }

            return previousCount; 
        }
 
#if !FEATURE_PAL 
        [ResourceExposure(ResourceScope.None)]
        [ResourceConsumption(ResourceScope.Machine, ResourceScope.Machine)] 
        public SemaphoreSecurity GetAccessControl() {
            return new SemaphoreSecurity(SafeWaitHandle, AccessControlSections.Access | AccessControlSections.Owner | AccessControlSections.Group);
        }
 
        [ResourceExposure(ResourceScope.Machine)]
        [ResourceConsumption(ResourceScope.Machine)] 
        public void SetAccessControl(SemaphoreSecurity semaphoreSecurity) { 
            if (semaphoreSecurity == null)
                throw new ArgumentNullException("semaphoreSecurity"); 

            semaphoreSecurity.Persist(SafeWaitHandle);
        }
#endif 
    }
} 
 

// File provided for Reference Use Only by Microsoft Corporation (c) 2007.

                        

                        

                        
                        

Link Menu

This book is available now!
Buy at Amazon US or
Buy at Amazon UK

• XmlSchema.cs
• DetailsViewUpdateEventArgs.cs
• SQLBoolean.cs
• BevelBitmapEffect.cs
• EventLogPermission.cs
• XPathEmptyIterator.cs
• SerializableTypeCodeDomSerializer.cs
• ToolStripItemTextRenderEventArgs.cs
• MatrixTransform3D.cs
• ArglessEventHandlerProxy.cs
• AutoCompleteStringCollection.cs
• SmtpAuthenticationManager.cs
• PhysicalAddress.cs
• RadioButtonBaseAdapter.cs
• CatalogZoneDesigner.cs
• DataGridCell.cs
• TypefaceMetricsCache.cs
• WindowsAuthenticationEventArgs.cs
• ByteArrayHelperWithString.cs
• PtsHelper.cs
• entitydatasourceentitysetnameconverter.cs
• ExpressionBuilder.cs
• ColumnHeaderConverter.cs
• ScriptingAuthenticationServiceSection.cs
• WebBrowserNavigatingEventHandler.cs
• ToolStripAdornerWindowService.cs
• EqualityArray.cs
• NamedPipeProcessProtocolHandler.cs
• CombinedGeometry.cs
• PolicyChain.cs
• XmlSchemaIdentityConstraint.cs
• BulletedList.cs
• TextElementCollectionHelper.cs
• EmptyEnumerable.cs
• RtType.cs
• Msec.cs
• QilTargetType.cs
• WebZoneDesigner.cs
• ProxyWebPartConnectionCollection.cs
• NamedPipeChannelFactory.cs
• CompressionTracing.cs
• Base64Stream.cs
• PartialTrustVisibleAssembly.cs
• FileChangesMonitor.cs
• OletxDependentTransaction.cs
• PtsCache.cs
• DPAPIProtectedConfigurationProvider.cs
• NamespaceMapping.cs
• ElementUtil.cs
• XPathNodeHelper.cs
• TextRange.cs
• LineMetrics.cs
• IndexedGlyphRun.cs
• CompiledIdentityConstraint.cs
• ImageButton.cs
• FormViewInsertedEventArgs.cs
• Region.cs
• ColorTranslator.cs
• WindowHideOrCloseTracker.cs
• FacetValueContainer.cs
• ProxyHelper.cs
• OuterProxyWrapper.cs
• AssemblyBuilder.cs
• PrtCap_Public.cs
• OuterGlowBitmapEffect.cs
• AsymmetricKeyExchangeFormatter.cs
• WindowsRegion.cs
• BasePattern.cs
• Timeline.cs
• AxHostDesigner.cs
• DynamicDocumentPaginator.cs
• LabelLiteral.cs
• SimpleType.cs
• WSSecureConversationDec2005.cs
• Application.cs
• WebServiceEnumData.cs
• EventData.cs
• DecoderFallback.cs
• ClickablePoint.cs
• FormClosedEvent.cs
• OracleRowUpdatingEventArgs.cs
• SessionEndedEventArgs.cs
• FileStream.cs
• AsyncOperationManager.cs
• Serializer.cs
• _Events.cs
• TreeViewCancelEvent.cs
• PropertyToken.cs
• DomNameTable.cs
• DecoderNLS.cs
• SplitterEvent.cs
• InkPresenter.cs
• HandlerWithFactory.cs
• ProfileManager.cs
• PageOutputQuality.cs
• JsonServiceDocumentSerializer.cs
• DependencyObjectPropertyDescriptor.cs
• TaskFileService.cs
• DefaultPropertiesToSend.cs
• namescope.cs