MutexRights Enumerazione

Riferimento

Definizione

Spazio dei nomi:: System.Security.AccessControl

Assembly:: System.Threading.AccessControl.dll

Assembly:: mscorlib.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Specifica i diritti di controllo di accesso che possono essere applicati a oggetti mutex di sistema denominati.

Questa enumerazione supporta una combinazione bit per bit dei rispettivi valori dei membri.

public enum class MutexRights

[System.Flags]
public enum MutexRights

[System.Flags]
[System.Security.SecurityCritical]
public enum MutexRights

[<System.Flags>]
type MutexRights =

[<System.Flags>]
[<System.Security.SecurityCritical>]
type MutexRights =

Public Enum MutexRights

Ereditarietà: Object

ValueType

Enum
MutexRights

Attributi: FlagsAttribute SecurityCriticalAttribute

Campi

ChangePermissions	262144	Diritto di modificare le regole di sicurezza e di controllo associate a un mutex denominato.
Delete	65536	Diritto di eliminare un mutex denominato.
FullControl	2031617	Diritto di esercitare il controllo completo su un mutex denominato e di modificarne le regole di accesso e le regole di controllo.
Modify	1	Diritto di rilasciare un mutex denominato.
ReadPermissions	131072	Diritto di aprire e copiare le regole di accesso e le regole di controllo per un mutex denominato.
Synchronize	1048576	Diritto di restare in attesa di un mutex denominato.
TakeOwnership	524288	Diritto di modificare il proprietario di un mutex denominato.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso dei valori durante la creazione e MutexAccessRule l'uso di MutexRights oggetti. L'esempio crea un MutexSecurity oggetto, aggiunge regole che consentono e negano vari diritti per l'utente corrente e visualizzano la coppia risultante di regole. L'esempio consente quindi nuovi diritti per l'utente corrente e visualizza il risultato, che mostra che i nuovi diritti vengono uniti alla regola esistente AccessControlType.Allow .

Nota

In questo esempio non viene collegato l'oggetto di sicurezza a un Mutex oggetto; vedere MutexSecurity, Mutex.GetAccessControl metodo e 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.
        MutexAccessRule rule = new MutexAccessRule(user, 
            MutexRights.Synchronize | MutexRights.Modify, 
            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);

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

        ' Add a rule that grants the current user the 
        ' right to enter or release the mutex.
        Dim rule As New MutexAccessRule(user, _
            MutexRights.Synchronize _
            Or MutexRights.Modify, _
            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)

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

Commenti

Usare l'enumerazione MutexRights per specificare i diritti di controllo di accesso quando si creano MutexSecurity oggetti. Per applicare i diritti di accesso a un mutex di sistema denominato, usare MutexSecurity oggetti con il costruttore e il Mutex(Boolean, String, Boolean, MutexSecurity) Mutex.SetAccessControl metodo .

Si applica a