EventWaitHandleSecurity.RemoveAccessRule(EventWaitHandleAccessRule) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vyhledá pravidlo řízení přístupu se stejným uživatelem a AccessControlType (povolí nebo odepře) jako zadané pravidlo přístupu a s kompatibilními příznaky dědičnosti a šíření. Pokud se takové pravidlo najde, práva obsažená v zadaném pravidle přístupu se z něj odeberou.
public:
bool RemoveAccessRule(System::Security::AccessControl::EventWaitHandleAccessRule ^ rule);public bool RemoveAccessRule (System.Security.AccessControl.EventWaitHandleAccessRule rule);override this.RemoveAccessRule : System.Security.AccessControl.EventWaitHandleAccessRule -> boolPublic Function RemoveAccessRule (rule As EventWaitHandleAccessRule) As BooleanParametry
Určuje EventWaitHandleAccessRule uživatele a AccessControlType má hledat a sadu příznaků dědičnosti a šíření, se kterými musí být odpovídající pravidlo, pokud je nalezeno, kompatibilní. Určuje práva, která se mají odebrat z kompatibilního pravidla, pokud jsou nalezena.
Návraty
truepokud je nalezeno kompatibilní pravidlo; v opačném případě . false
Výjimky
rule je null.
Příklady
Následující příklad kódu ukazuje použití RemoveAccessRule metody k odebrání práv z Allow pravidla v objektu EventWaitHandleSecurity . Ukazuje také, že ostatní práva v souboru rule jsou ignorována.
Příklad vytvoří EventWaitHandleSecurity objekt a přidá pravidla, která aktuálnímu uživateli povolují a zamítnou různá práva. Mezi povolená práva patří Modify, ReadPermissionsa Synchronize. Příklad pak vytvoří nové pravidlo pro aktuálního uživatele, včetně ReadPermissions práv a TakeOwnership a použije toto pravidlo s metodou RemoveAccessRule k odebrání ReadPermissions z Allow pravidla v objektu EventWaitHandleSecurity . Práva TakeOwnership v rule se ignorují.
Poznámka
Tento příklad nepřipojí objekt zabezpečení k objektu EventWaitHandle . Příklady, které připojují objekty zabezpečení, najdete v EventWaitHandle.GetAccessControl a EventWaitHandle.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.
EventWaitHandleSecurity mSec = new EventWaitHandleSecurity();
// Add a rule that grants the current user the
// right to wait on or signal the event and read the
// permissions on the event.
EventWaitHandleAccessRule rule = new EventWaitHandleAccessRule(user,
EventWaitHandleRights.Synchronize | EventWaitHandleRights.Modify
| EventWaitHandleRights.ReadPermissions,
AccessControlType.Allow);
mSec.AddAccessRule(rule);
// Add a rule that denies the current user the
// right to change permissions on the event.
rule = new EventWaitHandleAccessRule(user,
EventWaitHandleRights.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 event, and
// take ownership of the event. 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 EventWaitHandleAccessRule(user,
EventWaitHandleRights.TakeOwnership |
EventWaitHandleRights.ReadPermissions,
AccessControlType.Allow);
mSec.RemoveAccessRule(rule);
ShowSecurity(mSec);
}
private static void ShowSecurity(EventWaitHandleSecurity security)
{
Console.WriteLine("\r\nCurrent access rules:\r\n");
foreach(EventWaitHandleAccessRule 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.EventWaitHandleRights);
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 EventWaitHandleSecurity()
' Add a rule that grants the current user the
' right to wait on or signal the event, and to
' read its permissions.
Dim rule As New EventWaitHandleAccessRule(user, _
EventWaitHandleRights.Synchronize _
Or EventWaitHandleRights.Modify _
Or EventWaitHandleRights.ReadPermissions, _
AccessControlType.Allow)
mSec.AddAccessRule(rule)
' Add a rule that denies the current user the
' right to change permissions on the event.
rule = New EventWaitHandleAccessRule(user, _
EventWaitHandleRights.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 event, and
' take ownership of the event. 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 EventWaitHandleAccessRule(user, _
EventWaitHandleRights.TakeOwnership _
Or EventWaitHandleRights.ReadPermissions, _
AccessControlType.Allow)
mSec.RemoveAccessRule(rule)
ShowSecurity(mSec)
End Sub
Private Shared Sub ShowSecurity(ByVal security As EventWaitHandleSecurity)
Console.WriteLine(vbCrLf & "Current access rules:" & vbCrLf)
For Each ar As EventWaitHandleAccessRule In _
security.GetAccessRules(True, True, GetType(NTAccount))
Console.WriteLine(" User: {0}", ar.IdentityReference)
Console.WriteLine(" Type: {0}", ar.AccessControlType)
Console.WriteLine(" Rights: {0}", ar.EventWaitHandleRights)
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
Poznámky
EventWaitHandleSecurity Aktuální se vyhledá pravidlo, které má stejného uživatele a stejnou AccessControlType hodnotu jako rule. Pokud se takové pravidlo nenajde, neprovedou se žádné akce a metoda vrátí false. Pokud se najdou odpovídající pravidla, zkontrolují se jejich příznaky dědičnosti a kompatibility z hlediska kompatibility s příznaky zadanými v rule. Pokud není nalezeno žádné kompatibilní pravidlo, neprovedou se žádné akce a metoda vrátí false. Pokud se najde pravidlo s kompatibilními příznaky, práva zadaná v rule nástroji se odeberou z kompatibilního pravidla a metoda vrátí true. Pokud rule specifikuje práva, která nejsou obsažena v kompatibilním pravidle, nebude s ohledem na tato práva provedena žádná akce. Pokud jsou z kompatibilního pravidla odebrána všechna práva, z aktuálního EventWaitHandleSecurity objektu se odebere celé pravidlo.
Důležité
I když můžete určit příznaky dědičnosti a šíření pro pravidla přístupu k událostem, jejich vytvoření metodou AccessRuleFactory se to nedoporučuje. Dědičnost a šíření nemají pro pojmenované události žádný význam a komplikují údržbu pravidel přístupu.
