MutexRights MutexRights MutexRights MutexRights Enum

Definizione

Specifica i diritti di controllo di accesso che possono essere applicati a oggetti mutex di sistema denominati.Specifies the access control rights that can be applied to named system mutex objects.

Questa enumerazione ha un attributo FlagsAttribute che consente una combinazione bit per bit dei valori del relativo membro.

public enum class MutexRights
[System.Flags]
[System.Security.SecurityCritical]
public enum MutexRights
type MutexRights = 
Public Enum MutexRights
Ereditarietà
Attributi

Campi

ChangePermissions ChangePermissions ChangePermissions ChangePermissions 262144

Diritto di modificare le regole di sicurezza e di controllo associate a un mutex denominato.The right to change the security and audit rules associated with a named mutex.

Delete Delete Delete Delete 65536

Diritto di eliminare un mutex denominato.The right to delete a named mutex.

FullControl FullControl FullControl FullControl 2031617

Diritto di esercitare il controllo completo su un mutex denominato e di modificarne le regole di accesso e le regole di controllo.The right to exert full control over a named mutex, and to modify its access rules and audit rules.

Modify Modify Modify Modify 1

Diritto di rilasciare un mutex denominato.The right to release a named mutex.

ReadPermissions ReadPermissions ReadPermissions ReadPermissions 131072

Diritto di aprire e copiare le regole di accesso e le regole di controllo per un mutex denominato.The right to open and copy the access rules and audit rules for a named mutex.

Synchronize Synchronize Synchronize Synchronize 1048576

Diritto di restare in attesa di un mutex denominato.The right to wait on a named mutex.

TakeOwnership TakeOwnership TakeOwnership TakeOwnership 524288

Diritto di modificare il proprietario di un mutex denominato.The right to change the owner of a named mutex.

Esempi

Nell'esempio di codice riportato di seguito viene MutexRights illustrato l'utilizzo dei valori MutexAccessRule durante la creazione e l'utilizzo di oggetti.The following code example demonstrates the use of MutexRights values when creating and using MutexAccessRule objects. Nell'esempio viene creato MutexSecurity un oggetto, vengono aggiunte regole che consentono e negano diversi diritti per l'utente corrente e viene visualizzata la coppia di regole risultante.The example creates an MutexSecurity object, adds rules that allow and deny various rights for the current user, and displays the resulting pair of rules. Nell'esempio vengono quindi consentiti nuovi diritti per l'utente corrente e viene visualizzato il risultato, mostrando che i nuovi diritti vengono AccessControlType.Allow Uniti con la regola esistente.The example then allows new rights for the current user and displays the result, showing that the new rights are merged with the existing AccessControlType.Allow rule.

Nota

In questo esempio l'oggetto di sicurezza non viene collegato Mutex a un oggetto MutexSecurity; Mutex.GetAccessControl vedere, metodo Mutex.SetAccessControle.This example does not attach the security object to a Mutex object; see MutexSecurity, Mutex.GetAccessControl method, and 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

Utilizzare l' MutexRights enumerazione per specificare i diritti di controllo di accesso MutexSecurity quando si creano oggetti.Use the MutexRights enumeration to specify access control rights when you create MutexSecurity objects. Per applicare i diritti di accesso a un mutex di sistema MutexSecurity denominato, usare Mutex(Boolean, String, Boolean, MutexSecurity) gli oggetti con Mutex.SetAccessControl il costruttore e il metodo.To apply access rights to a named system mutex, use MutexSecurity objects with the Mutex(Boolean, String, Boolean, MutexSecurity) constructor and the Mutex.SetAccessControl method.

Nota

La sicurezza per gli oggetti di sincronizzazione non è supportata per Windows 98 o Windows Millennium Edition.Security on synchronization objects is not supported for Windows 98 or Windows Millennium Edition.

Si applica a

Vedi anche