MutexAccessRule クラス

定義

public ref class MutexAccessRule sealed : System::Security::AccessControl::AccessRule

public sealed class MutexAccessRule : System.Security.AccessControl.AccessRule

[System.Security.SecurityCritical]
public sealed class MutexAccessRule : System.Security.AccessControl.AccessRule

type MutexAccessRule = class
    inherit AccessRule

[<System.Security.SecurityCritical>]
type MutexAccessRule = class
    inherit AccessRule

Public NotInheritable Class MutexAccessRule
Inherits AccessRule

継承

Object

AuthorizationRule

AccessRule

MutexAccessRule

属性

SecurityCriticalAttribute

例

次のコード例は、オブジェクトの作成と使用を MutexAccessRule 示しています。 この例では、 オブジェクトを MutexSecurity 作成し、現在のユーザーに対してさまざまな権限を許可または拒否する規則を追加し、結果の規則のペアを表示します。 次に、現在のユーザーに対して新しい権限を許可し、新しい権限が既存 Allow のルールとマージされていることを示す結果を表示します。

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

注釈

クラスはMutexAccessRule、名前付きシステム ミューテックスの Windows アクセス制御セキュリティを管理するために.NET Frameworkが提供するクラスのセットの 1 つです。 これらのクラスの概要と、基になる Windows アクセス制御構造との関係については、「」を参照してください MutexSecurity。

名前付きミューテックスに現在適用されている規則の一覧を取得するには、 メソッドを Mutex.GetAccessControl 使用してオブジェクトを MutexSecurity 取得し、そのメソッドを GetAccessRules 使用してオブジェクトの MutexAccessRule コレクションを取得します。

MutexAccessRule オブジェクトは、基になる随意アクセス制御リスト (DACL) のアクセス制御エントリと一対一ではマップされません。 ミューテックスのすべてのアクセス規則のセットを取得すると、セットには、すべてのアクセス制御エントリを表すために現在必要なルールの最小数が含まれます。

オブジェクトを使用して MutexAccessRule 、ユーザーまたはグループに対して許可または拒否するアクセス権を指定します。 オブジェクトは MutexAccessRule 常に、許可されたアクセスまたは拒否されたアクセスを表し、両方を表すことはありません。

名前付きシステム ミューテックスにルールを適用するには、 メソッドを Mutex.GetAccessControl 使用して オブジェクトを MutexSecurity 取得します。 オブジェクトを変更するには、 MutexSecurity そのメソッドを使用してルールを追加し、 メソッドを Mutex.SetAccessControl 使用してセキュリティ オブジェクトを再アタッチします。

MutexAccessRule オブジェクトは不変です。 ミューテックスのセキュリティは、 クラスの メソッドを使用してルールを MutexSecurity 追加または削除して変更されます。この操作を行うと、基になるアクセス制御エントリが変更されます。

コンストラクター

プロパティ

メソッド

適用対象

こちらもご覧ください

• MutexSecurity