EventWaitHandleSecurity.RemoveAccessRule(EventWaitHandleAccessRule) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Осуществляет поиск правила управления доступом с тем же именем пользователя и значением AccessControlType ("разрешить" или "запретить"), что и указанного правила доступа, а также с совместимыми флагами наследования и распространения; если правило найдено, содержащиеся в указанном правиле доступа права удаляются.
public:
bool RemoveAccessRule(System::Security::AccessControl::EventWaitHandleAccessRule ^ rule);public bool RemoveAccessRule (System.Security.AccessControl.EventWaitHandleAccessRule rule);override this.RemoveAccessRule : System.Security.AccessControl.EventWaitHandleAccessRule -> boolPublic Function RemoveAccessRule (rule As EventWaitHandleAccessRule) As BooleanПараметры
Объект EventWaitHandleAccessRule, определяющий пользователя и тип AccessControlType для поиска, а также набор флагов наследования и распространения, с которыми должно быть совместимо найденное правило. Задает права, которые требуется удалить из совместимого правила, если оно будет найдено.
Возвращаемое значение
Значение true, если совместимое правило найдено; в противном случае — значение false.
Исключения
rule имеет значение null.
Примеры
В следующем примере кода показано использование метода для RemoveAccessRule удаления прав из Allow правила в объекте EventWaitHandleSecurity . Он также показывает, что другие права в rule игнорируются.
В примере создается EventWaitHandleSecurity объект и добавляются правила, которые разрешают и запрещают различные права для текущего пользователя. Права допускается включать Modify, ReadPermissions, и Synchronize. Затем в примере создается новое правило для текущего пользователя, включая ReadPermissions и TakeOwnership прав и использует правила с RemoveAccessRule способ удаления ReadPermissions из Allow правило из EventWaitHandleSecurity объекта. Право TakeOwnership в rule игнорируется.
Примечание
В этом примере объект безопасности не присоединяет к объекту EventWaitHandle . Примеры присоединения объектов безопасности можно найти в EventWaitHandle.GetAccessControl и EventWaitHandle.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.
EventWaitHandleSecurity mSec = new EventWaitHandleSecurity();
// Add a rule that grants the current user the
// right to wait on or signal the event and read the
// permissions on the event.
EventWaitHandleAccessRule rule = new EventWaitHandleAccessRule(user,
EventWaitHandleRights.Synchronize | EventWaitHandleRights.Modify
| EventWaitHandleRights.ReadPermissions,
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);
// Create a rule that grants the current user
// the right to read permissions on the event, and
// take ownership of the event. Use this rule to
// remove the right to read permissions from the
// Allow rule for the current user. The inclusion
// of the right to take ownership has no effect.
rule = new EventWaitHandleAccessRule(user,
EventWaitHandleRights.TakeOwnership |
EventWaitHandleRights.ReadPermissions,
AccessControlType.Allow);
mSec.RemoveAccessRule(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, ReadPermissions, Synchronize
Current access rules:
User: TestDomain\TestUser
Type: Deny
Rights: ChangePermissions
User: TestDomain\TestUser
Type: Allow
Rights: Modify, 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, and to
' read its permissions.
Dim rule As New EventWaitHandleAccessRule(user, _
EventWaitHandleRights.Synchronize _
Or EventWaitHandleRights.Modify _
Or EventWaitHandleRights.ReadPermissions, _
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)
' Create a rule that grants the current user
' the right to read permissions on the event, and
' take ownership of the event. Use this rule to
' remove the right to read permissions from the
' Allow rule for the current user. The inclusion
' of the right to take ownership has no effect.
rule = New EventWaitHandleAccessRule(user, _
EventWaitHandleRights.TakeOwnership _
Or EventWaitHandleRights.ReadPermissions, _
AccessControlType.Allow)
mSec.RemoveAccessRule(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, ReadPermissions, Synchronize
'
'
'Current access rules:
'
' User: TestDomain\TestUser
' Type: Deny
' Rights: ChangePermissions
'
' User: TestDomain\TestUser
' Type: Allow
' Rights: Modify, Synchronize
Комментарии
Текущий EventWaitHandleSecurity ищется правило, которое имеет тот же пользователь и имеет одинаковые AccessControlType значение как rule. Если такое правило не найдено, никаких действий не выполняется, и метод возвращает false. Если правила сопоставления найдены, их флагов наследования и совместимости проверка на совместимость с флагов, указанных в rule. Если не совместимое правило найдено, никакие действия не выполняются, и метод возвращает false. Если обнаруживается правило с совместимыми флагами, права, указанные в rule удаляются из совместимого правила, а метод возвращает true. Если rule задает права, не содержится в совместимого правила, никакие действия не выполняются по отношению к эти права. Если все права удаляются из совместимого правила, правило целиком удаляется из текущей EventWaitHandleSecurity объекта.
Важно!
Хотя можно указать флаги наследования и распространения для правил доступа к событиям, создав их с AccessRuleFactory помощью метода , это не рекомендуется. Наследование и распространение не имеют смысла для именованных событий, и они усложняют обслуживание правил доступа.
