(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

EventWaitHandleAccessRule-Klasse

Stellt eine Gruppe von Zugriffsrechten dar, die einem Benutzer oder einer Gruppe gewährt oder verweigert werden. Diese Klasse kann nicht vererbt werden.

Namespace:  System.Security.AccessControl
Assembly:  mscorlib (in mscorlib.dll)

public sealed class EventWaitHandleAccessRule : AccessRule

Der EventWaitHandleAccessRule-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeEventWaitHandleAccessRule(IdentityReference, EventWaitHandleRights, AccessControlType)Initialisiert eine neue Instanz der EventWaitHandleAccessRule-Klasse und gibt den Benutzer oder die Gruppe an, für den bzw. die die Regel gilt. Außerdem werden die Zugriffsrechte angegeben und ob diese gewährt oder verweigert werden.
Öffentliche MethodeEventWaitHandleAccessRule(String, EventWaitHandleRights, AccessControlType)Initialisiert eine neue Instanz der EventWaitHandleAccessRule-Klasse und gibt den Namen des Benutzers oder der Gruppe an, für den bzw. die die Regel gilt. Außerdem werden die Zugriffsrechte angegeben und ob diese gewährt oder verweigert werden.
Zum Seitenanfang

  NameBeschreibung
Öffentliche EigenschaftAccessControlTypeRuft den AccessControlType-Wert ab, der diesem AccessRule-Objekt zugeordnet ist. (Von AccessRule geerbt.)
Geschützte EigenschaftAccessMaskRuft die Zugriffsmaske für diese Regel ab. (Von AuthorizationRule geerbt.)
Öffentliche EigenschaftEventWaitHandleRightsRuft die von der Zugriffsregel gewährten oder verweigerten Rechte ab.
Öffentliche EigenschaftIdentityReferenceRuft die IdentityReference ab, für die diese Regel gilt. (Von AuthorizationRule geerbt.)
Öffentliche EigenschaftInheritanceFlagsRuft den Wert von Flags ab, mit denen bestimmt wird, wie diese Regel von untergeordneten Objekten geerbt wird. (Von AuthorizationRule geerbt.)
Öffentliche EigenschaftIsInheritedRuft einen Wert ab, der angibt, ob diese Regel explizit festgelegt oder von einem übergeordneten Containerobjekt geerbt wird. (Von AuthorizationRule geerbt.)
Öffentliche EigenschaftPropagationFlagsRuft den Wert der Weitergabeflags ab, die bestimmen, wie die Vererbung dieser Regel an untergeordnete Objekte weitergegeben wird. Diese Eigenschaft ist nur dann relevant, wenn der Wert der InheritanceFlags-Enumeration nicht None ist. (Von AuthorizationRule geerbt.)
Zum Seitenanfang

  NameBeschreibung
Öffentliche MethodeEquals(Object)Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
Öffentliche MethodeGetHashCodeFungiert als die Standardhashfunktion. (Von Object geerbt.)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang

Die EventWaitHandleAccessRule-Klasse gehört zu einer von .NET Framework bereitgestellten Gruppe von Klassen zur Verwaltung der Windows-Zugriffssteuerungssicherheit für benannte Systemereignisse. Eine Übersicht über diese Klassen und ihre Beziehung zu den zugrunde liegenden Windows-Zugriffssteuerungsstrukturen finden Sie unter EventWaitHandleSecurity.

HinweisHinweis

Windows-Zugriffssteuerungssicherheit ist nur für benannte Systemereignisse von Bedeutung. Wenn ein EventWaitHandle-Objekt ein lokales Ereignis darstellt, ist die Zugriffssteuerung irrelevant.

Sie erhalten eine Liste der derzeit auf ein benanntes Ereignis angewendeten Regeln, indem Sie mit der EventWaitHandle.GetAccessControl-Methode ein EventWaitHandleSecurity-Objekt abrufen und anschließend mit der zugehörigen GetAccessRules-Methode eine Auflistung von EventWaitHandleAccessRule-Objekten abrufen.

EventWaitHandleAccessRule -Objekte können Einträgen für die Zugriffssteuerung in der zugrunde liegenden DACL (Discretionary Access Control List, freigegebene Zugriffssteuerungsliste) nicht eins zu eins zugeordnet werden. Die Gruppe aller für ein Ereignis abgerufenen Zugriffsregeln enthält nur die minimale Anzahl von Regeln, die derzeit zur Beschreibung aller Zugriffssteuerungseinträge erforderlich ist.

HinweisHinweis

Die zugrunde liegenden Zugriffssteuerungseinträge ändern sich, wenn Sie Regeln anwenden oder entfernen. Die Informationen in Regeln werden, wenn möglich, zusammengeführt, um die Anzahl der Zugriffssteuerungseinträge möglichst gering zu halten. Beim Abrufen der aktuellen Regelliste stellen Sie daher möglicherweise Abweichungen gegenüber der Liste aller von Ihnen hinzugefügten Regeln fest.

Geben Sie mit EventWaitHandleAccessRule-Objekten die Zugriffsrechte an, die einem Benutzer oder einer Gruppe gewährt oder verweigert werden sollen. Ein EventWaitHandleAccessRule-Objekt stellt immer entweder einen gewährten oder einen verweigerte Zugriff dar, nie beide.

Sie können eine Regel auf ein benanntes Systemereignis anwenden, indem Sie das EventWaitHandleSecurity-Objekt mit der EventWaitHandle.GetAccessControl-Methode abrufen. Ändern Sie das EventWaitHandleSecurity-Objekt, indem Sie die zugehörigen Methoden verwenden, um die Regel hinzuzufügen, und verwenden Sie anschließend die EventWaitHandle.SetAccessControl-Methode, um das Sicherheitsobjekt erneut anzufügen.

Wichtiger HinweisWichtig

Änderungen an einem EventWaitHandleSecurity-Objekt wirken sich erst dann auf die Zugriffsebenen für das benannte Ereignis aus, wenn die EventWaitHandle.SetAccessControl-Methode aufgerufen wird, um dem benannten Ereignis das geänderte Sicherheitsobjekt zuzuweisen.

EventWaitHandleAccessRule -Objekte sind unveränderlich. Die Sicherheitseinstellungen für ein Ereignis werden geändert, indem mit den Methoden der EventWaitHandleSecurity-Klasse Regeln hinzugefügt oder entfernt werden. Dabei werden die zugrunde liegenden Zugriffssteuerungseinträge geändert.

HinweisHinweis

Sicherheit wird für Synchronisierungsobjekte für Windows 98 oder Windows Millennium Edition nicht unterstützt.

Im folgenden Codebeispiel werden die Erstellung und die Verwendung von EventWaitHandleAccessRule-Objekten veranschaulicht. Im Beispiel wird ein EventWaitHandleSecurity-Objekt erstellt. Außerdem werden Regeln hinzugefügt, die dem aktuellen Benutzer eine Reihe von Rechten gewähren und verweigern, und das erhaltene Regelpaar wird angezeigt. Anschließend werden dem aktuellen Benutzer im Beispiel neue Rechte gewährt und das Ergebnis wird angezeigt, das die Zusammenführung der neuen Rechte mit der vorhandenen Allow-Regel darstellt.

HinweisHinweis

In diesem Beispiel wird das Sicherheitsobjekt nicht an ein EventWaitHandle-Objekt angefügt. Beispiele, in denen Sicherheitsobjekte angefügt werden, finden Sie unter EventWaitHandle.GetAccessControl und 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
 */


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft