EventWaitHandleSecurity 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示套用至具名系統等候控制代碼 (Wait Handle) 的 Windows 存取控制安全性。 此類別無法獲得繼承。
public ref class EventWaitHandleSecurity sealed : System::Security::AccessControl::NativeObjectSecuritypublic sealed class EventWaitHandleSecurity : System.Security.AccessControl.NativeObjectSecurity[System.Security.SecurityCritical]
public sealed class EventWaitHandleSecurity : System.Security.AccessControl.NativeObjectSecuritytype EventWaitHandleSecurity = class
inherit NativeObjectSecurity[<System.Security.SecurityCritical>]
type EventWaitHandleSecurity = class
inherit NativeObjectSecurityPublic NotInheritable Class EventWaitHandleSecurity
Inherits NativeObjectSecurity- 繼承
- 屬性
範例
下列程式代碼範例示範規則與Deny規則之間的Allow區隔，以及顯示相容規則中許可權的組合。 此範例會 EventWaitHandleSecurity 建立 物件、新增規則，以允許和拒絕目前使用者的各種許可權，並顯示產生的規則組。 然後，此範例會允許目前使用者的新許可權，並顯示結果，顯示新許可權會與現有 Allow 規則合併。
注意
這個範例不會將安全性物件附加至 EventWaitHandle 物件。 您可以在和 EventWaitHandle.SetAccessControl中找到EventWaitHandle.GetAccessControl附加安全性物件的範例。
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
*/
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 EventWaitHandleSecurity()
' Add a rule that grants the current user the
' right to wait on or signal the event.
Dim rule As New EventWaitHandleAccessRule(user, _
EventWaitHandleRights.Synchronize _
Or 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)
End Sub
Private Shared Sub ShowSecurity(ByVal security As EventWaitHandleSecurity)
Console.WriteLine(vbCrLf & "Current access rules:" & vbCrLf)
For Each ar As EventWaitHandleAccessRule In _
security.GetAccessRules(True, True, GetType(NTAccount))
Console.WriteLine(" User: {0}", ar.IdentityReference)
Console.WriteLine(" Type: {0}", ar.AccessControlType)
Console.WriteLine(" Rights: {0}", ar.EventWaitHandleRights)
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
備註
EventWaitHandleSecurity物件會指定具名系統等候句柄的訪問許可權，並指定稽核存取嘗試的方式。 等候句柄的訪問許可權會以規則表示，每個存取規則都由 EventWaitHandleAccessRule 物件表示。 每個稽核規則都是由 EventWaitHandleAuditRule 物件表示。
這會鏡像基礎 Windows 安全性系統，其中每個安全性實體最多都有一個選擇性訪問控制清單， (DACL) 控制安全物件的存取權，而且最多一個系統訪問控制清單 (SACL) ，以指定稽核哪些存取嘗試。 DACL 和 SACL 是 ACE) (存取控制專案的排序列表，可指定使用者和群組的存取和稽核。 EventWaitHandleAccessRule或 EventWaitHandleAuditRule 物件可能代表一個以上的 ACE。
注意
EventWaitHandle物件可以代表本機等候句柄或具名系統等候句柄。 Windows 訪問控制安全性僅適用於具名系統等候句柄。
EventWaitHandleSecurity、 EventWaitHandleAccessRule和類別會隱藏 ACL 和 EventWaitHandleAuditRule ACE 的實作詳細數據。 它們可讓您忽略十七個不同的 ACE 類型，以及正確維護訪問許可權繼承和傳播的複雜性。 這些物件也設計為防止下列常見的訪問控制錯誤：
使用 Null DACL 建立安全性描述元。 DACL 的 Null 參考可讓任何使用者將存取規則新增至物件，而可能會建立拒絕服務攻擊。 新的 EventWaitHandleSecurity 物件一律會以空的 DACL 開頭，這會拒絕所有使用者的所有存取。
違反 ACE 標準順序。 如果 DACL 中的 ACE 列表未依標準順序保留，使用者可能會不小心被授與安全物件的存取權。 例如，拒絕的訪問許可權必須一律出現在允許的訪問許可權之前。 EventWaitHandleSecurity 物件會在內部維持正確的順序。
操作安全性描述元旗標，其應該只在資源管理員控制之下。
建立無效的 ACE 旗標組合。
操作繼承的 ACE。 資源管理員會處理繼承和傳播，以回應您對存取和稽核規則所做的變更。
將無意義的 ACE 插入 ACL。
.NET 安全性物件不支援的唯一功能是大部分應用程式開發人員應該避免的風險活動，例如：
資源管理員通常會執行的低階工作。
以不維護標準順序的方式新增或移除訪問控制專案。
若要修改具名等候句柄的 Windows 存取控制安全性，請使用 EventWaitHandle.GetAccessControl 方法來取得 EventWaitHandleSecurity 物件。 藉由新增和移除規則來修改安全性對象，然後使用 EventWaitHandle.SetAccessControl 方法來重新附加它。
重要
對物件所做的 EventWaitHandleSecurity 變更不會影響具名等候句柄的存取層級，直到您呼叫 EventWaitHandle.SetAccessControl 方法，將已改變的安全性物件指派給具名等候句柄為止。
若要將訪問控制安全性從一個等候句柄複製到另一個等候句柄，請使用 EventWaitHandle.GetAccessControl 方法取得 EventWaitHandleSecurity 代表第一個等候句柄之存取和稽核規則的物件，然後使用 EventWaitHandle.SetAccessControl 方法或接受 EventWaitHandleSecurity 物件的建構函式，將這些規則指派給第二個等候句柄。
投資安全性描述元定義語言的使用者 (SDDL) 可以使用 SetSecurityDescriptorSddlForm 方法來設定具名等候句柄的存取規則，以及 GetSecurityDescriptorSddlForm 取得字串，以 SDDL 格式表示存取規則。 不建議用於新的開發。
建構函式
| EventWaitHandleSecurity() |
使用預設值，初始化 EventWaitHandleSecurity 類別的新執行個體。 |
