EventWaitHandleRights 列舉

定義

命名空間:

System.Security.AccessControl

組件:

System.Threading.AccessControl.dll

套件:

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

來源:

EventWaitHandleSecurity.cs

指定可套用至具名系統事件物件的存取控制 (Access Control) 權限。

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

C#

[System.Flags]
public enum EventWaitHandleRights

繼承

Object

ValueType

Enum

EventWaitHandleRights

屬性

FlagsAttribute

欄位

名稱	值	Description
ChangePermissions	262144	變更與具名事件相關聯之安全性和稽核規則的權限。
Delete	65536	刪除具名事件的權限。
FullControl	2031619	對具名事件執行完全控制以及修改其存取規則和稽核規則的權限。
Modify	2	設定或重設具名事件之信號狀態的權限。
ReadPermissions	131072	開啟並複製具名事件之存取規則和稽核規則的權限。
Synchronize	1048576	等候具名事件的權限。
TakeOwnership	524288	變更具名事件擁有人的權限。

範例

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

備註

這個範例不會將安全性物件附加至 EventWaitHandle 物件;請參閱 EventWaitHandleSecurity、 EventWaitHandle.GetAccessControl 方法和 EventWaitHandle.SetAccessControl。

C#

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
 */

備註

當您建立EventWaitHandleAccessRule物件時，EventWaitHandleRights請使用 列舉來指定訪問控制許可權。 若要將訪問許可權套用至具名系統事件，請先將物件新增EventWaitHandleAccessRule至物件，然後使用建構函式或 EventWaitHandle.SetAccessControl 方法將EventWaitHandleSecurity物件附加至具名系統事件EventWaitHandle.EventWaitHandle(Boolean, EventResetMode, String, Boolean, EventWaitHandleSecurity)EventWaitHandleSecurity。

適用於

另請參閱

• EventWaitHandleAccessRule
• EventWaitHandleSecurity