Code:
/ Net / Net / 3.5.50727.3053 / DEVDIV / depot / DevDiv / releases / whidbey / netfxsp / ndp / clr / src / BCL / System / Security / AccessControl / MutexSecurity.cs / 1 / MutexSecurity.cs
// ==++== // // Copyright (c) Microsoft Corporation. All rights reserved. // // ==--== /*============================================================ ** ** Class: MutexSecurity ** ** ** Purpose: Managed ACL wrapper for Win32 mutexes. ** ** ===========================================================*/ using System; using System.Collections; using System.Security.Permissions; using System.Security.Principal; using Microsoft.Win32; using Microsoft.Win32.SafeHandles; using System.Runtime.InteropServices; using System.IO; using System.Threading; namespace System.Security.AccessControl { // Derive this list of values from winnt.h and MSDN docs: // http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dllproc/base/synchronization_object_security_and_access_rights.asp // In order to call ReleaseMutex, you must have an ACL granting you // MUTEX_MODIFY_STATE rights (0x0001). The other interesting value // in a Mutex's ACL is MUTEX_ALL_ACCESS (0x1F0001). // You need SYNCHRONIZE to be able to open a handle to a mutex. [Flags] public enum MutexRights { Modify = 0x000001, Delete = 0x010000, ReadPermissions = 0x020000, ChangePermissions = 0x040000, TakeOwnership = 0x080000, Synchronize = 0x100000, // SYNCHRONIZE FullControl = 0x1F0001 } public sealed class MutexAccessRule : AccessRule { // Constructor for creating access rules for registry objects public MutexAccessRule(IdentityReference identity, MutexRights eventRights, AccessControlType type) : this(identity, (int) eventRights, false, InheritanceFlags.None, PropagationFlags.None, type) { } public MutexAccessRule(String identity, MutexRights eventRights, AccessControlType type) : this(new NTAccount(identity), (int) eventRights, false, InheritanceFlags.None, PropagationFlags.None, type) { } // // Internal constructor to be called by public constructors // and the access rule factory methods of {File|Folder}Security // internal MutexAccessRule( IdentityReference identity, int accessMask, bool isInherited, InheritanceFlags inheritanceFlags, PropagationFlags propagationFlags, AccessControlType type ) : base( identity, accessMask, isInherited, inheritanceFlags, propagationFlags, type ) { } public MutexRights MutexRights { get { return (MutexRights) base.AccessMask; } } } public sealed class MutexAuditRule : AuditRule { public MutexAuditRule(IdentityReference identity, MutexRights eventRights, AuditFlags flags) : this(identity, (int) eventRights, false, InheritanceFlags.None, PropagationFlags.None, flags) { } /* // Not in the spec public MutexAuditRule(string identity, MutexRights eventRights, AuditFlags flags) : this(new NTAccount(identity), (int) eventRights, false, InheritanceFlags.None, PropagationFlags.None, flags) { } */ internal MutexAuditRule(IdentityReference identity, int accessMask, bool isInherited, InheritanceFlags inheritanceFlags, PropagationFlags propagationFlags, AuditFlags flags) : base(identity, accessMask, isInherited, inheritanceFlags, propagationFlags, flags) { } public MutexRights MutexRights { get { return (MutexRights) base.AccessMask; } } } public sealed class MutexSecurity : NativeObjectSecurity { public MutexSecurity() : base(true, ResourceType.KernelObject) { } public MutexSecurity(String name, AccessControlSections includeSections) : base(true, ResourceType.KernelObject, name, includeSections, _HandleErrorCode, null) { // Let the underlying ACL API's demand unmanaged code permission. } internal MutexSecurity(SafeWaitHandle handle, AccessControlSections includeSections) : base(true, ResourceType.KernelObject, handle, includeSections, _HandleErrorCode, null) { // Let the underlying ACL API's demand unmanaged code permission. } private static Exception _HandleErrorCode(int errorCode, string name, SafeHandle handle, object context) { System.Exception exception = null; switch (errorCode) { case Win32Native.ERROR_INVALID_NAME: case Win32Native.ERROR_INVALID_HANDLE: case Win32Native.ERROR_FILE_NOT_FOUND: if ((name != null) && (name.Length != 0)) exception = new WaitHandleCannotBeOpenedException(Environment.GetResourceString("Threading.WaitHandleCannotBeOpenedException_InvalidHandle", name)); else exception = new WaitHandleCannotBeOpenedException(); break; default: break; } return exception; } public override AccessRule AccessRuleFactory(IdentityReference identityReference, int accessMask, bool isInherited, InheritanceFlags inheritanceFlags, PropagationFlags propagationFlags, AccessControlType type) { return new MutexAccessRule(identityReference, accessMask, isInherited, inheritanceFlags, propagationFlags, type); } public override AuditRule AuditRuleFactory(IdentityReference identityReference, int accessMask, bool isInherited, InheritanceFlags inheritanceFlags, PropagationFlags propagationFlags, AuditFlags flags) { return new MutexAuditRule(identityReference, accessMask, isInherited, inheritanceFlags, propagationFlags, flags); } internal AccessControlSections GetAccessControlSectionsFromChanges() { AccessControlSections persistRules = AccessControlSections.None; if (AccessRulesModified) persistRules = AccessControlSections.Access; if (AuditRulesModified) persistRules |= AccessControlSections.Audit; if (OwnerModified) persistRules |= AccessControlSections.Owner; if (GroupModified) persistRules |= AccessControlSections.Group; return persistRules; } internal void Persist(SafeWaitHandle handle) { // Let the underlying ACL API's demand unmanaged code. WriteLock(); try { AccessControlSections persistSections = GetAccessControlSectionsFromChanges(); if (persistSections == AccessControlSections.None) return; // Don't need to persist anything. base.Persist(handle, persistSections); OwnerModified = GroupModified = AuditRulesModified = AccessRulesModified = false; } finally { WriteUnlock(); } } public void AddAccessRule(MutexAccessRule rule) { base.AddAccessRule(rule); } public void SetAccessRule(MutexAccessRule rule) { base.SetAccessRule(rule); } public void ResetAccessRule(MutexAccessRule rule) { base.ResetAccessRule(rule); } public bool RemoveAccessRule(MutexAccessRule rule) { return base.RemoveAccessRule(rule); } public void RemoveAccessRuleAll(MutexAccessRule rule) { base.RemoveAccessRuleAll(rule); } public void RemoveAccessRuleSpecific(MutexAccessRule rule) { base.RemoveAccessRuleSpecific(rule); } public void AddAuditRule(MutexAuditRule rule) { base.AddAuditRule(rule); } public void SetAuditRule(MutexAuditRule rule) { base.SetAuditRule(rule); } public bool RemoveAuditRule(MutexAuditRule rule) { return base.RemoveAuditRule(rule); } public void RemoveAuditRuleAll(MutexAuditRule rule) { base.RemoveAuditRuleAll(rule); } public void RemoveAuditRuleSpecific(MutexAuditRule rule) { base.RemoveAuditRuleSpecific(rule); } public override Type AccessRightType { get { return typeof(MutexRights); } } public override Type AccessRuleType { get { return typeof(MutexAccessRule); } } public override Type AuditRuleType { get { return typeof(MutexAuditRule); } } } } // File provided for Reference Use Only by Microsoft Corporation (c) 2007. // ==++== // // Copyright (c) Microsoft Corporation. All rights reserved. // // ==--== /*============================================================ ** ** Class: MutexSecurity ** ** ** Purpose: Managed ACL wrapper for Win32 mutexes. ** ** ===========================================================*/ using System; using System.Collections; using System.Security.Permissions; using System.Security.Principal; using Microsoft.Win32; using Microsoft.Win32.SafeHandles; using System.Runtime.InteropServices; using System.IO; using System.Threading; namespace System.Security.AccessControl { // Derive this list of values from winnt.h and MSDN docs: // http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dllproc/base/synchronization_object_security_and_access_rights.asp // In order to call ReleaseMutex, you must have an ACL granting you // MUTEX_MODIFY_STATE rights (0x0001). The other interesting value // in a Mutex's ACL is MUTEX_ALL_ACCESS (0x1F0001). // You need SYNCHRONIZE to be able to open a handle to a mutex. [Flags] public enum MutexRights { Modify = 0x000001, Delete = 0x010000, ReadPermissions = 0x020000, ChangePermissions = 0x040000, TakeOwnership = 0x080000, Synchronize = 0x100000, // SYNCHRONIZE FullControl = 0x1F0001 } public sealed class MutexAccessRule : AccessRule { // Constructor for creating access rules for registry objects public MutexAccessRule(IdentityReference identity, MutexRights eventRights, AccessControlType type) : this(identity, (int) eventRights, false, InheritanceFlags.None, PropagationFlags.None, type) { } public MutexAccessRule(String identity, MutexRights eventRights, AccessControlType type) : this(new NTAccount(identity), (int) eventRights, false, InheritanceFlags.None, PropagationFlags.None, type) { } // // Internal constructor to be called by public constructors // and the access rule factory methods of {File|Folder}Security // internal MutexAccessRule( IdentityReference identity, int accessMask, bool isInherited, InheritanceFlags inheritanceFlags, PropagationFlags propagationFlags, AccessControlType type ) : base( identity, accessMask, isInherited, inheritanceFlags, propagationFlags, type ) { } public MutexRights MutexRights { get { return (MutexRights) base.AccessMask; } } } public sealed class MutexAuditRule : AuditRule { public MutexAuditRule(IdentityReference identity, MutexRights eventRights, AuditFlags flags) : this(identity, (int) eventRights, false, InheritanceFlags.None, PropagationFlags.None, flags) { } /* // Not in the spec public MutexAuditRule(string identity, MutexRights eventRights, AuditFlags flags) : this(new NTAccount(identity), (int) eventRights, false, InheritanceFlags.None, PropagationFlags.None, flags) { } */ internal MutexAuditRule(IdentityReference identity, int accessMask, bool isInherited, InheritanceFlags inheritanceFlags, PropagationFlags propagationFlags, AuditFlags flags) : base(identity, accessMask, isInherited, inheritanceFlags, propagationFlags, flags) { } public MutexRights MutexRights { get { return (MutexRights) base.AccessMask; } } } public sealed class MutexSecurity : NativeObjectSecurity { public MutexSecurity() : base(true, ResourceType.KernelObject) { } public MutexSecurity(String name, AccessControlSections includeSections) : base(true, ResourceType.KernelObject, name, includeSections, _HandleErrorCode, null) { // Let the underlying ACL API's demand unmanaged code permission. } internal MutexSecurity(SafeWaitHandle handle, AccessControlSections includeSections) : base(true, ResourceType.KernelObject, handle, includeSections, _HandleErrorCode, null) { // Let the underlying ACL API's demand unmanaged code permission. } private static Exception _HandleErrorCode(int errorCode, string name, SafeHandle handle, object context) { System.Exception exception = null; switch (errorCode) { case Win32Native.ERROR_INVALID_NAME: case Win32Native.ERROR_INVALID_HANDLE: case Win32Native.ERROR_FILE_NOT_FOUND: if ((name != null) && (name.Length != 0)) exception = new WaitHandleCannotBeOpenedException(Environment.GetResourceString("Threading.WaitHandleCannotBeOpenedException_InvalidHandle", name)); else exception = new WaitHandleCannotBeOpenedException(); break; default: break; } return exception; } public override AccessRule AccessRuleFactory(IdentityReference identityReference, int accessMask, bool isInherited, InheritanceFlags inheritanceFlags, PropagationFlags propagationFlags, AccessControlType type) { return new MutexAccessRule(identityReference, accessMask, isInherited, inheritanceFlags, propagationFlags, type); } public override AuditRule AuditRuleFactory(IdentityReference identityReference, int accessMask, bool isInherited, InheritanceFlags inheritanceFlags, PropagationFlags propagationFlags, AuditFlags flags) { return new MutexAuditRule(identityReference, accessMask, isInherited, inheritanceFlags, propagationFlags, flags); } internal AccessControlSections GetAccessControlSectionsFromChanges() { AccessControlSections persistRules = AccessControlSections.None; if (AccessRulesModified) persistRules = AccessControlSections.Access; if (AuditRulesModified) persistRules |= AccessControlSections.Audit; if (OwnerModified) persistRules |= AccessControlSections.Owner; if (GroupModified) persistRules |= AccessControlSections.Group; return persistRules; } internal void Persist(SafeWaitHandle handle) { // Let the underlying ACL API's demand unmanaged code. WriteLock(); try { AccessControlSections persistSections = GetAccessControlSectionsFromChanges(); if (persistSections == AccessControlSections.None) return; // Don't need to persist anything. base.Persist(handle, persistSections); OwnerModified = GroupModified = AuditRulesModified = AccessRulesModified = false; } finally { WriteUnlock(); } } public void AddAccessRule(MutexAccessRule rule) { base.AddAccessRule(rule); } public void SetAccessRule(MutexAccessRule rule) { base.SetAccessRule(rule); } public void ResetAccessRule(MutexAccessRule rule) { base.ResetAccessRule(rule); } public bool RemoveAccessRule(MutexAccessRule rule) { return base.RemoveAccessRule(rule); } public void RemoveAccessRuleAll(MutexAccessRule rule) { base.RemoveAccessRuleAll(rule); } public void RemoveAccessRuleSpecific(MutexAccessRule rule) { base.RemoveAccessRuleSpecific(rule); } public void AddAuditRule(MutexAuditRule rule) { base.AddAuditRule(rule); } public void SetAuditRule(MutexAuditRule rule) { base.SetAuditRule(rule); } public bool RemoveAuditRule(MutexAuditRule rule) { return base.RemoveAuditRule(rule); } public void RemoveAuditRuleAll(MutexAuditRule rule) { base.RemoveAuditRuleAll(rule); } public void RemoveAuditRuleSpecific(MutexAuditRule rule) { base.RemoveAuditRuleSpecific(rule); } public override Type AccessRightType { get { return typeof(MutexRights); } } public override Type AccessRuleType { get { return typeof(MutexAccessRule); } } public override Type AuditRuleType { get { return typeof(MutexAuditRule); } } } } // 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
- SecureUICommand.cs
- CatalogZone.cs
- PersonalizationState.cs
- VariableQuery.cs
- MessagingDescriptionAttribute.cs
- OracleConnection.cs
- ListItemConverter.cs
- AssemblyBuilder.cs
- HotSpotCollection.cs
- StateDesigner.LayoutSelectionGlyph.cs
- X509ImageLogo.cs
- EnumCodeDomSerializer.cs
- ObjectMaterializedEventArgs.cs
- WebReference.cs
- IdentityValidationException.cs
- CngProperty.cs
- EntityProviderFactory.cs
- SafeNativeMemoryHandle.cs
- QilInvoke.cs
- CSharpCodeProvider.cs
- DelegatingTypeDescriptionProvider.cs
- ClientOptions.cs
- SqlDataReaderSmi.cs
- SignedPkcs7.cs
- SignatureResourcePool.cs
- ConfigurationValidatorBase.cs
- ParentControlDesigner.cs
- CreateUserErrorEventArgs.cs
- SelectionWordBreaker.cs
- SecurityHeaderLayout.cs
- MimeReturn.cs
- SettingsBase.cs
- FlagPanel.cs
- wgx_sdk_version.cs
- WindowsFont.cs
- LazyTextWriterCreator.cs
- Metadata.cs
- InternalConfigHost.cs
- RowType.cs
- SecurityChannelFactory.cs
- TextCollapsingProperties.cs
- CapabilitiesUse.cs
- TokenBasedSet.cs
- WebPartVerb.cs
- FormView.cs
- GeneralTransform.cs
- BoolExpressionVisitors.cs
- OperatorExpressions.cs
- WSHttpBindingBase.cs
- SpotLight.cs
- DataGridViewTextBoxCell.cs
- ColumnHeaderConverter.cs
- BitmapEffectInput.cs
- ViewBox.cs
- LocalizableAttribute.cs
- New.cs
- FrameAutomationPeer.cs
- FacetDescriptionElement.cs
- DefaultClaimSet.cs
- TraversalRequest.cs
- TextTreeRootNode.cs
- MappingSource.cs
- BitmapData.cs
- ObjectDataSourceView.cs
- ObjectDataSourceView.cs
- InfoCardBaseException.cs
- StringToken.cs
- MemoryMappedFile.cs
- CommunicationObjectManager.cs
- ComponentResourceManager.cs
- HtmlInputPassword.cs
- TextEditorDragDrop.cs
- TrackingMemoryStream.cs
- EventLogEntryCollection.cs
- ArgumentDesigner.xaml.cs
- EntityClientCacheEntry.cs
- SapiInterop.cs
- ThreadStaticAttribute.cs
- CDSsyncETWBCLProvider.cs
- CssClassPropertyAttribute.cs
- CodeDirectoryCompiler.cs
- StickyNoteHelper.cs
- ObjectDataSourceView.cs
- SecureEnvironment.cs
- GrabHandleGlyph.cs
- FormViewRow.cs
- EditingMode.cs
- TextBoxLine.cs
- ImageField.cs
- EventSchemaTraceListener.cs
- FunctionOverloadResolver.cs
- XmlAutoDetectWriter.cs
- ValidateNames.cs
- PersonalizationState.cs
- DisposableCollectionWrapper.cs
- WindowsScroll.cs
- PtsCache.cs
- WebPartPersonalization.cs
- CqlIdentifiers.cs
- CodeDomSerializerBase.cs