EventWaitHandleAccessRule Konstruktory

Reference

Definice

Obor názvů:: System.Security.AccessControl

Sestavení:: System.Threading.AccessControl.dll

Sestavení:: mscorlib.dll

Balíček:: System.Threading.AccessControl v9.0.0

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í.

Inicializuje novou instanci EventWaitHandleAccessRule třídy.

Přetížení

EventWaitHandleAccessRule(IdentityReference, EventWaitHandleRights, AccessControlType)	Inicializuje novou instanci EventWaitHandleAccessRule třídy s určením 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.
EventWaitHandleAccessRule(String, EventWaitHandleRights, AccessControlType)	Inicializuje novou instanci EventWaitHandleAccessRule třídy a určí 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.

EventWaitHandleAccessRule(IdentityReference, EventWaitHandleRights, AccessControlType)

Zdroj:: EventWaitHandleSecurity.cs

Zdroj:: EventWaitHandleSecurity.cs

Zdroj:: EventWaitHandleSecurity.cs

Zdroj:: EventWaitHandleSecurity.cs

Inicializuje novou instanci EventWaitHandleAccessRule třídy s určením 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.

public:
 EventWaitHandleAccessRule(System::Security::Principal::IdentityReference ^ identity, System::Security::AccessControl::EventWaitHandleRights eventRights, System::Security::AccessControl::AccessControlType type);

public EventWaitHandleAccessRule (System.Security.Principal.IdentityReference identity, System.Security.AccessControl.EventWaitHandleRights eventRights, System.Security.AccessControl.AccessControlType type);

new System.Security.AccessControl.EventWaitHandleAccessRule : System.Security.Principal.IdentityReference * System.Security.AccessControl.EventWaitHandleRights * System.Security.AccessControl.AccessControlType -> System.Security.AccessControl.EventWaitHandleAccessRule

Public Sub New (identity As IdentityReference, eventRights As EventWaitHandleRights, type As AccessControlType)

Parametry

identity: IdentityReference

Uživatel nebo skupina, na které se pravidlo vztahuje. Musí být typu SecurityIdentifier nebo typu NTAccount , který lze převést na typ SecurityIdentifier.

eventRights: EventWaitHandleRights

Bitová kombinace EventWaitHandleRights hodnot určujících práva povolená nebo odepřená.

type: AccessControlType

Jedna z AccessControlType hodnot určujících, zda jsou práva povolena nebo odepřena.

Výjimky

ArgumentOutOfRangeException

eventRights určuje neplatnou hodnotu.

-nebo-

type určuje neplatnou hodnotu.

ArgumentNullException

identity je null.

-nebo-

eventRights je nula.

ArgumentException

identity není typu SecurityIdentifier , ani typu, který NTAccount lze převést na typ SecurityIdentifier.

Poznámky

Pokud chcete čekat na metodu EventWaitHandle WaitOne(voláním metody , WaitAny nebo WaitAll ), musí mít EventWaitHandleRights.Synchronize uživatel přístup. Aby bylo možné signalizovat událost voláním Set metody nebo ji obnovit do nepodepisovaného stavu voláním Reset metody, musí mít EventWaitHandleRights.Modify uživatel přístup. Pokud chcete objekt signalizovat EventWaitHandle a pak na něj počkat voláním SignalAndWait metody, musí mít Synchronize uživatel přístup.Modify

Platí pro

EventWaitHandleAccessRule(String, EventWaitHandleRights, AccessControlType)

Zdroj:: EventWaitHandleSecurity.cs

Zdroj:: EventWaitHandleSecurity.cs

Zdroj:: EventWaitHandleSecurity.cs

Zdroj:: EventWaitHandleSecurity.cs

Inicializuje novou instanci EventWaitHandleAccessRule třídy a určí 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.

public:
 EventWaitHandleAccessRule(System::String ^ identity, System::Security::AccessControl::EventWaitHandleRights eventRights, System::Security::AccessControl::AccessControlType type);

public EventWaitHandleAccessRule (string identity, System.Security.AccessControl.EventWaitHandleRights eventRights, System.Security.AccessControl.AccessControlType type);

new System.Security.AccessControl.EventWaitHandleAccessRule : string * System.Security.AccessControl.EventWaitHandleRights * System.Security.AccessControl.AccessControlType -> System.Security.AccessControl.EventWaitHandleAccessRule

Public Sub New (identity As String, eventRights As EventWaitHandleRights, type As AccessControlType)

Parametry

identity: String

Jméno uživatele nebo skupiny, na které se pravidlo vztahuje.

eventRights: EventWaitHandleRights

Bitová kombinace EventWaitHandleRights hodnot určujících práva povolená nebo odepřená.

type: AccessControlType

Jedna z AccessControlType hodnot určujících, zda jsou práva povolena nebo odepřena.

Výjimky

ArgumentOutOfRangeException

eventRights určuje neplatnou hodnotu.

-nebo-

type určuje neplatnou hodnotu.

ArgumentNullException

eventRights je nula.

ArgumentException

identity je null.

-nebo-

identity je řetězec nulové délky.

-nebo-

identity je delší než 512 znaků.

Příklady

Následující příklad kódu ukazuje použití tohoto konstruktoru k vytvoření EventWaitHandleAccessRule objektů. Příklad vytvoří EventWaitHandleSecurity objekt, přidá pravidla, která povolují a odmítnou různá práva pro aktuálního uživatele, a zobrazí výslednou dvojici pravidel. Příklad pak povolí nová práva pro 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řipoutuje 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.
        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

Tento konstruktor je ekvivalentem vytvoření objektu NTAccount předáním identity konstruktoru NTAccount.NTAccount(String) a předáním nově vytvořeného NTAccount objektu konstruktoru EventWaitHandleAccessRule(IdentityReference, EventWaitHandleRights, AccessControlType) .

Platí pro

Sdílet prostřednictvím

EventWaitHandleAccessRule Konstruktory

Definice

Přetížení

EventWaitHandleAccessRule(IdentityReference, EventWaitHandleRights, AccessControlType)

Parametry

Výjimky

Poznámky

Platí pro

EventWaitHandleAccessRule(String, EventWaitHandleRights, AccessControlType)

Parametry

Výjimky

Příklady

Poznámky

Platí pro

Další materiály