Code:
/ Dotnetfx_Win7_3.5.1 / Dotnetfx_Win7_3.5.1 / 3.5.1 / DEVDIV / depot / DevDiv / releases / whidbey / NetFXspW7 / 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
- ReverseInheritProperty.cs
- RootProfilePropertySettingsCollection.cs
- DispatchWrapper.cs
- ProbeMatchesMessageCD1.cs
- ElementFactory.cs
- DesignerCalendarAdapter.cs
- QueryTreeBuilder.cs
- PropertyMap.cs
- RegistrationProxy.cs
- ZipPackage.cs
- BasicAsyncResult.cs
- DecimalConverter.cs
- ContextStaticAttribute.cs
- ServerValidateEventArgs.cs
- CheckBox.cs
- tabpagecollectioneditor.cs
- MDIControlStrip.cs
- XmlNode.cs
- BrowserCapabilitiesCodeGenerator.cs
- ClipboardProcessor.cs
- initElementDictionary.cs
- XamlReader.cs
- PartitionResolver.cs
- SingleObjectCollection.cs
- PropertyState.cs
- ConfigurationManager.cs
- SystemIPv6InterfaceProperties.cs
- XmlAnyAttributeAttribute.cs
- TreeNodeStyleCollection.cs
- DataColumnMappingCollection.cs
- ListViewItem.cs
- NativeWindow.cs
- EndCreateSecurityTokenRequest.cs
- AdCreatedEventArgs.cs
- ChangePasswordDesigner.cs
- ToolboxItemWrapper.cs
- XmlCollation.cs
- ProcessHostMapPath.cs
- DataList.cs
- SplineKeyFrames.cs
- NetworkAddressChange.cs
- BooleanAnimationBase.cs
- PropertyGridCommands.cs
- mediaeventshelper.cs
- AddInToken.cs
- RandomNumberGenerator.cs
- DocumentGrid.cs
- ErrorEventArgs.cs
- EventPrivateKey.cs
- AssemblyBuilder.cs
- ByteStorage.cs
- AddressUtility.cs
- WebErrorHandler.cs
- DocumentScope.cs
- EventToken.cs
- ComponentGlyph.cs
- DodSequenceMerge.cs
- TypeEnumerableViewSchema.cs
- SpecularMaterial.cs
- FlowStep.cs
- DataSvcMapFile.cs
- DataView.cs
- GZipDecoder.cs
- Int64Converter.cs
- CqlLexer.cs
- NotSupportedException.cs
- ThreadAttributes.cs
- SelectorItemAutomationPeer.cs
- ConsumerConnectionPoint.cs
- ArraySubsetEnumerator.cs
- MouseOverProperty.cs
- XmlAttributeProperties.cs
- CodeAccessPermission.cs
- AttributeCollection.cs
- EventProviderWriter.cs
- HttpConfigurationContext.cs
- CodeCatchClause.cs
- _LoggingObject.cs
- AmbiguousMatchException.cs
- HttpEncoderUtility.cs
- PrivateUnsafeNativeCompoundFileMethods.cs
- Rect.cs
- DataMemberFieldEditor.cs
- SortedDictionary.cs
- ToolTip.cs
- Object.cs
- HtmlToClrEventProxy.cs
- TdsParserStateObject.cs
- DataGrid.cs
- XmlDataSourceView.cs
- Comparer.cs
- TextEditorParagraphs.cs
- StorageSetMapping.cs
- GridEntry.cs
- ThicknessAnimationBase.cs
- DateTimeOffsetStorage.cs
- ChangeNode.cs
- MergeFailedEvent.cs
- DecimalStorage.cs
- TableLayoutCellPaintEventArgs.cs