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
- ProofTokenCryptoHandle.cs
- FixedSOMFixedBlock.cs
- XmlQualifiedNameTest.cs
- InkSerializer.cs
- Attributes.cs
- ToolStripPanel.cs
- DataBindingHandlerAttribute.cs
- EntityDataSourceDataSelection.cs
- DateTimeParse.cs
- ResourcePermissionBase.cs
- OleDbMetaDataFactory.cs
- ChannelHandler.cs
- EmissiveMaterial.cs
- FactoryRecord.cs
- Unit.cs
- MoveSizeWinEventHandler.cs
- mda.cs
- ToolZoneDesigner.cs
- InfoCardConstants.cs
- Process.cs
- InputLangChangeEvent.cs
- ErrorFormatterPage.cs
- WebPartUserCapability.cs
- FindSimilarActivitiesVerb.cs
- BindingExpressionUncommonField.cs
- XmlEncodedRawTextWriter.cs
- ReverseComparer.cs
- WebPartEventArgs.cs
- ConfigurationException.cs
- exports.cs
- BamlLocalizableResourceKey.cs
- SecurityDocument.cs
- PtsHelper.cs
- Path.cs
- EncodingTable.cs
- TraceUtility.cs
- Matrix3D.cs
- QuaternionKeyFrameCollection.cs
- HorizontalAlignConverter.cs
- InvalidOperationException.cs
- XmlElementList.cs
- ObjectItemCollection.cs
- CollectionDataContract.cs
- DesignBindingPicker.cs
- ShapeTypeface.cs
- ExpressionBuilder.cs
- ShaderEffect.cs
- HttpPostedFileWrapper.cs
- TextSelectionHelper.cs
- EntryPointNotFoundException.cs
- IsolationInterop.cs
- DataSourceXmlSerializer.cs
- ControlPropertyNameConverter.cs
- HttpCookiesSection.cs
- RegisteredScript.cs
- ElapsedEventArgs.cs
- SHA384.cs
- CursorInteropHelper.cs
- DataGridViewDataErrorEventArgs.cs
- AutomationElementIdentifiers.cs
- XmlnsCompatibleWithAttribute.cs
- XmlValidatingReaderImpl.cs
- List.cs
- SecurityHelper.cs
- MLangCodePageEncoding.cs
- Connection.cs
- HtmlMobileTextWriter.cs
- ToolStripTextBox.cs
- WbmpConverter.cs
- DbMetaDataColumnNames.cs
- XmlCountingReader.cs
- XmlComment.cs
- DataGridViewRowsAddedEventArgs.cs
- AddInIpcChannel.cs
- RootBuilder.cs
- GenericPrincipal.cs
- XmlExtensionFunction.cs
- SystemWebCachingSectionGroup.cs
- InstancePersistenceEvent.cs
- Freezable.cs
- ThreadStateException.cs
- FastEncoderWindow.cs
- ShaderEffect.cs
- FileChangesMonitor.cs
- AstTree.cs
- AuthenticatingEventArgs.cs
- CodeNamespace.cs
- TdsParserStateObject.cs
- _NestedMultipleAsyncResult.cs
- ContentControl.cs
- NavigationProperty.cs
- HttpResponse.cs
- SqlIdentifier.cs
- TextDecoration.cs
- IPAddressCollection.cs
- XmlObjectSerializerWriteContextComplexJson.cs
- ToolStripOverflowButton.cs
- GridViewRowCollection.cs
- HashAlgorithm.cs
- DetailsViewModeEventArgs.cs