EventWaitHandleAccessRule Třída

Definice

Obor názvů:

System.Security.AccessControl

Sestavení:

System.Threading.AccessControl.dll

Sestavení:

mscorlib.dll

Představuje sadu přístupových práv povolených nebo odepřených pro uživatele nebo skupinu. Tuto třídu nelze dědit.

public ref class EventWaitHandleAccessRule sealed : System::Security::AccessControl::AccessRule

public sealed class EventWaitHandleAccessRule : System.Security.AccessControl.AccessRule

[System.Security.SecurityCritical]
public sealed class EventWaitHandleAccessRule : System.Security.AccessControl.AccessRule

type EventWaitHandleAccessRule = class
    inherit AccessRule

[<System.Security.SecurityCritical>]
type EventWaitHandleAccessRule = class
    inherit AccessRule

Public NotInheritable Class EventWaitHandleAccessRule
Inherits AccessRule

Dědičnost

Object

AuthorizationRule

AccessRule

EventWaitHandleAccessRule

Atributy

SecurityCriticalAttribute

Příklady

Následující příklad kódu ukazuje vytvoření a použití EventWaitHandleAccessRule objektů. Příklad vytvoří EventWaitHandleSecurity objekt, přidá pravidla, která povolují a zakazují různá práva pro aktuálního uživatele, a zobrazí výslednou dvojici pravidel. Příklad pak umožňuje novým právem aktuálního uživatele a zobrazí výsledek, který ukazuje, že nová práva jsou sloučena s existujícím Allow pravidlem.

Poznámka

Tento příklad nepřipokládá objekt zabezpečení k objektu EventWaitHandle . Příklady, které připojují objekty zabezpečení, najdete v EventWaitHandle.GetAccessControl souboru 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.
        EventWaitHandleAccessRule rule = new EventWaitHandleAccessRule(user, 
            EventWaitHandleRights.Synchronize | EventWaitHandleRights.Modify, 
            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);

        // Add a rule that allows the current user the 
        // right to read permissions on the event. This rule
        // is merged with the existing Allow rule.
        rule = new EventWaitHandleAccessRule(user, 
            EventWaitHandleRights.ReadPermissions, 
            AccessControlType.Allow);
        mSec.AddAccessRule(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, Synchronize


Current access rules:

        User: TestDomain\TestUser
        Type: Deny
      Rights: ChangePermissions

        User: TestDomain\TestUser
        Type: Allow
      Rights: Modify, ReadPermissions, 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.
        Dim rule As New EventWaitHandleAccessRule(user, _
            EventWaitHandleRights.Synchronize _
            Or EventWaitHandleRights.Modify, _
            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)

        ' Add a rule that allows the current user the 
        ' right to read permissions on the event. This rule
        ' is merged with the existing Allow rule.
        rule = New EventWaitHandleAccessRule(user, _
            EventWaitHandleRights.ReadPermissions, _
            AccessControlType.Allow)
        mSec.AddAccessRule(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, Synchronize
'
'
'Current access rules:
'
'        User: TestDomain\TestUser
'        Type: Deny
'      Rights: ChangePermissions
'
'        User: TestDomain\TestUser
'        Type: Allow
'      Rights: Modify, ReadPermissions, Synchronize

Poznámky

Třída EventWaitHandleAccessRule je jednou ze sady tříd, které .NET Framework poskytuje pro správu Windows zabezpečení řízení přístupu u pojmenovaných systémových událostí. Přehled těchto tříd a jejich vztah k podkladovým Windows strukturám řízení přístupu najdete v tématu EventWaitHandleSecurity.

Poznámka

Windows zabezpečení řízení přístupu je smysluplné jenom pro pojmenované systémové události. EventWaitHandle Pokud objekt představuje místní událost, řízení přístupu je irelevantní.

Chcete-li získat seznam pravidel aktuálně použitých pro pojmenovanou událost, použijte EventWaitHandle.GetAccessControl metodu k získání EventWaitHandleSecurity objektu a pak použijte jeho GetAccessRules metodu k získání kolekce EventWaitHandleAccessRule objektů.

EventWaitHandleAccessRule objekty nemapují 1:1 s položkami řízení přístupu v podkladovém seznamu řízení přístupu (DACL). Když získáte sadu všech pravidel přístupu pro událost, sada obsahuje minimální počet pravidel, která jsou aktuálně nutná k vyjádření všech položek řízení přístupu.

Poznámka

Základní položky řízení přístupu se mění při použití a odebírání pravidel. Pokud je to možné, informace v pravidlech se sloučí, aby se zachoval nejmenší počet položek řízení přístupu. Když tedy získáte aktuální seznam pravidel, nemusí vypadat přesně jako seznam všech pravidel, která jste přidali.

Pomocí EventWaitHandleAccessRule objektů můžete určit přístupová práva, která povolí nebo odepře uživateli nebo skupině. Objekt EventWaitHandleAccessRule vždy představuje povolený přístup nebo odepřený přístup, nikdy obojí.

Pokud chcete použít pravidlo pro pojmenovanou systémovou událost, použijte metodu EventWaitHandle.GetAccessControl k získání objektu EventWaitHandleSecurity . EventWaitHandleSecurity Upravte objekt pomocí svých metod pro přidání pravidla a pak použijte EventWaitHandle.SetAccessControl metodu k opětovnému připojení objektu zabezpečení.

Důležité

Změny provedené u objektu EventWaitHandleSecurity nemají vliv na úrovně přístupu pojmenované události, dokud nezavoláte EventWaitHandle.SetAccessControl metodu pro přiřazení změněného objektu zabezpečení k pojmenované události.

EventWaitHandleAccessRule objekty jsou neměnné. Zabezpečení události je změněno pomocí metod EventWaitHandleSecurity třídy pro přidání nebo odebrání pravidel; jak to uděláte, podkladové položky řízení přístupu jsou změněny.

Konstruktory

EventWaitHandleAccessRule(IdentityReference, EventWaitHandleRights, AccessControlType)	Inicializuje novou instanci EventWaitHandleAccessRule třídy, určuje uživatele nebo skupinu, na které se pravidlo vztahuje, přístupová práva a jestli jsou zadaná přístupová práva povolená nebo odepřená.
EventWaitHandleAccessRule(String, EventWaitHandleRights, AccessControlType)	Inicializuje novou instanci EventWaitHandleAccessRule třídy, určuje název uživatele nebo skupiny, na které se pravidlo vztahuje, přístupová práva a zda jsou zadaná přístupová práva povolena nebo odepřena.

Vlastnosti

AccessControlType	Získá hodnotu přidruženou AccessControlType k tomuto AccessRule objektu. (Zděděno od AccessRule)
AccessMask	Získá přístupová maska pro toto pravidlo. (Zděděno od AuthorizationRule)
EventWaitHandleRights	Získá práva povolená nebo odepřena pravidlem přístupu.
IdentityReference	Získá, IdentityReference na které se toto pravidlo vztahuje. (Zděděno od AuthorizationRule)
InheritanceFlags	Získá hodnotu příznaků, které určují, jak je toto pravidlo zděděno podřízenými objekty. (Zděděno od AuthorizationRule)
IsInherited	Získá hodnotu určující, zda je toto pravidlo explicitně nastaveno nebo je zděděno z nadřazeného objektu kontejneru. (Zděděno od AuthorizationRule)
PropagationFlags	Získá hodnotu příznaků šíření, které určují, jak se dědičnost tohoto pravidla rozšíří do podřízených objektů. Tato vlastnost je významná pouze v případě, že hodnota výčtu InheritanceFlags není None. (Zděděno od AuthorizationRule)

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• EventWaitHandleSecurity