MutexSecurity.RemoveAccessRule(MutexAccessRule) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Busca una regla de control de acceso con el mismo usuario y AccessControlType (permitir o denegar) que la regla especificada y con marcas de herencia y propagación compatibles; si se encuentra dicha regla, los derechos contenidos en la regla de acceso especificada se quitan de ella.
public:
bool RemoveAccessRule(System::Security::AccessControl::MutexAccessRule ^ rule);public bool RemoveAccessRule(System.Security.AccessControl.MutexAccessRule rule);override this.RemoveAccessRule : System.Security.AccessControl.MutexAccessRule -> boolPublic Function RemoveAccessRule (rule As MutexAccessRule) As BooleanParámetros
- rule
- MutexAccessRule
que MutexAccessRule especifica el usuario y AccessControlType para buscar, y un conjunto de marcas de herencia y propagación con las que debe ser compatible una regla coincidente, si se encuentra. Especifica los derechos que se van a quitar de la regla compatible, si se encuentra.
Devoluciones
true si se encuentra una regla compatible; de lo contrario false, es .
Excepciones
rule es null.
Ejemplos
En el ejemplo de código siguiente se muestra el uso del RemoveAccessRule método para quitar derechos de una Allow regla en un MutexSecurity objeto . También muestra que se omiten otros derechos de rule .
En el ejemplo se crea un MutexSecurity objeto y se agregan reglas que permiten y deniegan varios derechos para el usuario actual. Los derechos permitidos incluyen Modify, ReadPermissionsy Synchronize. A continuación, el ejemplo crea una nueva regla para el usuario actual, incluidos ReadPermissions los derechos y TakeOwnership , y usa esa regla con el RemoveAccessRule método para quitar ReadPermissions de la Allow regla en el MutexSecurity objeto . El derecho extraño TakeOwnership en rule se omite.
Note
En este ejemplo no se adjunta el objeto de seguridad a un Mutex objeto . Ejemplos que adjuntan objetos de seguridad se pueden encontrar en Mutex.GetAccessControl y Mutex.SetAccessControl.
using System;
using System.Threading;
using System.Security.AccessControl;
using System.Security.Principal;
public class Example
{
public static void Main()
{
// Create a string representing the current user.
string user = Environment.UserDomainName + "\\" +
Environment.UserName;
// Create a security object that grants no access.
MutexSecurity mSec = new MutexSecurity();
// Add a rule that grants the current user the
// right to enter or release the mutex and read the
// permissions on the mutex.
MutexAccessRule rule = new MutexAccessRule(user,
MutexRights.Synchronize | MutexRights.Modify
| MutexRights.ReadPermissions,
AccessControlType.Allow);
mSec.AddAccessRule(rule);
// Add a rule that denies the current user the
// right to change permissions on the mutex.
rule = new MutexAccessRule(user,
MutexRights.ChangePermissions,
AccessControlType.Deny);
mSec.AddAccessRule(rule);
// Display the rules in the security object.
ShowSecurity(mSec);
// Create a rule that grants the current user
// the right to read permissions on the mutex, and
// take ownership of the mutex. Use this rule to
// remove the right to read permissions from the
// Allow rule for the current user. The inclusion
// of the right to take ownership has no effect.
rule = new MutexAccessRule(user,
MutexRights.TakeOwnership |
MutexRights.ReadPermissions,
AccessControlType.Allow);
mSec.RemoveAccessRule(rule);
ShowSecurity(mSec);
}
private static void ShowSecurity(MutexSecurity security)
{
Console.WriteLine("\r\nCurrent access rules:\r\n");
foreach(MutexAccessRule ar in
security.GetAccessRules(true, true, typeof(NTAccount)))
{
Console.WriteLine(" User: {0}", ar.IdentityReference);
Console.WriteLine(" Type: {0}", ar.AccessControlType);
Console.WriteLine(" Rights: {0}", ar.MutexRights);
Console.WriteLine();
}
}
}
/*This code example produces output similar to following:
Current access rules:
User: TestDomain\TestUser
Type: Deny
Rights: ChangePermissions
User: TestDomain\TestUser
Type: Allow
Rights: Modify, ReadPermissions, Synchronize
Current access rules:
User: TestDomain\TestUser
Type: Deny
Rights: ChangePermissions
User: TestDomain\TestUser
Type: Allow
Rights: Modify, Synchronize
*/
Imports System.Threading
Imports System.Security.AccessControl
Imports System.Security.Principal
Public Class Example
Public Shared Sub Main()
' Create a string representing the current user.
Dim user As String = Environment.UserDomainName _
& "\" & Environment.UserName
' Create a security object that grants no access.
Dim mSec As New MutexSecurity()
' Add a rule that grants the current user the
' right to enter or release the mutex, and to
' read its permissions.
Dim rule As New MutexAccessRule(user, _
MutexRights.Synchronize _
Or MutexRights.Modify _
Or MutexRights.ReadPermissions, _
AccessControlType.Allow)
mSec.AddAccessRule(rule)
' Add a rule that denies the current user the
' right to change permissions on the mutex.
rule = New MutexAccessRule(user, _
MutexRights.ChangePermissions, _
AccessControlType.Deny)
mSec.AddAccessRule(rule)
' Display the rules in the security object.
ShowSecurity(mSec)
' Create a rule that grants the current user
' the right to read permissions on the mutex, and
' take ownership of the mutex. Use this rule to
' remove the right to read permissions from the
' Allow rule for the current user. The inclusion
' of the right to take ownership has no effect.
rule = New MutexAccessRule(user, _
MutexRights.TakeOwnership _
Or MutexRights.ReadPermissions, _
AccessControlType.Allow)
mSec.RemoveAccessRule(rule)
ShowSecurity(mSec)
End Sub
Private Shared Sub ShowSecurity(ByVal security As MutexSecurity)
Console.WriteLine(vbCrLf & "Current access rules:" & vbCrLf)
For Each ar As MutexAccessRule In _
security.GetAccessRules(True, True, GetType(NTAccount))
Console.WriteLine(" User: {0}", ar.IdentityReference)
Console.WriteLine(" Type: {0}", ar.AccessControlType)
Console.WriteLine(" Rights: {0}", ar.MutexRights)
Console.WriteLine()
Next
End Sub
End Class
'This code example produces output similar to following:
'
'Current access rules:
'
' User: TestDomain\TestUser
' Type: Deny
' Rights: ChangePermissions
'
' User: TestDomain\TestUser
' Type: Allow
' Rights: Modify, ReadPermissions, Synchronize
'
'
'Current access rules:
'
' User: TestDomain\TestUser
' Type: Deny
' Rights: ChangePermissions
'
' User: TestDomain\TestUser
' Type: Allow
' Rights: Modify, Synchronize
Comentarios
Se busca una regla que MutexSecurity tiene el mismo usuario y el mismo AccessControlType valor ruleque . Si no se encuentra ninguna regla de este tipo, no se realiza ninguna acción y el método devuelve false. Si se encuentran reglas de coincidencia, sus marcas de herencia y compatibilidad se comprueban por compatibilidad con las marcas especificadas en rule. Si no se encuentra ninguna regla compatible, no se realiza ninguna acción y el método devuelve false. Si se encuentra una regla con marcas compatibles, los derechos especificados en rule se quitan de la regla compatible y el método devuelve true. Si rule especifica derechos no incluidos en la regla compatible, no se realiza ninguna acción con respecto a esos derechos. Si se quitan todos los derechos de la regla compatible, se quita toda la regla del objeto actual MutexSecurity .
Importante
Aunque puede especificar marcas de herencia y propagación para las reglas de acceso a exclusión mutua, al crearlas con el AccessRuleFactory método , no se recomienda. La herencia y propagación no tienen ningún significado para las exclusión mutuas con nombre y hacen que el mantenimiento de las reglas de acceso sea más complicado.
