MutexRights 列舉

定義

命名空間:

System.Security.AccessControl

組件:

System.Threading.AccessControl.dll

套件:

System.Threading.AccessControl v9.0.0-rc.2.24473.5

來源:

MutexSecurity.cs

指定可套用至具名系統 Mutex 物件的存取控制權限。

此列舉支援其成員值的位元組合。

public enum class MutexRights

[System.Flags]
public enum MutexRights

[<System.Flags>]
type MutexRights = 

Public Enum MutexRights

繼承

Object

ValueType

Enum

MutexRights

屬性

FlagsAttribute

欄位

ChangePermissions	262144	變更與具名 Mutex 相關聯之安全性和稽核規則的權限。
Delete	65536	刪除具名 Mutex 的權限。
FullControl	2031617	對具名 Mutex 執行完全控制以及修改其存取規則和稽核規則的權限。
Modify	1	釋放具名 Mutex 的權限。
ReadPermissions	131072	開啟並複製具名 Mutex 之存取規則和稽核規則的權限。
Synchronize	1048576	等候具名 Mutex 的權限。
TakeOwnership	524288	變更具名 Mutex 擁有人的權限。

範例

下列程式代碼範例示範 MutexRights 在建立和使用 MutexAccessRule 物件時使用值。 此範例會 MutexSecurity 建立 物件、新增規則，以允許和拒絕目前使用者的各種許可權，並顯示產生的規則組。 此範例接著會允許目前使用者的新許可權，並顯示結果，顯示新許可權會與現有 AccessControlType.Allow 規則合併。

注意

這個範例不會將安全性物件附加至 Mutex 物件;請參閱 MutexSecurity、 Mutex.GetAccessControl 方法和 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

備註

當您建立MutexSecurity物件時，MutexRights請使用 列舉來指定訪問控制許可權。 若要將訪問許可權套用至具名系統 Mutex，請使用 MutexSecurity 物件搭配建 Mutex(Boolean, String, Boolean, MutexSecurity) 構函式和 Mutex.SetAccessControl 方法。

另請參閱

• MutexAccessRule
• MutexSecurity