EventWaitHandleSecurity.RemoveAccessRule メソッド
アセンブリ: mscorlib (mscorlib.dll 内)

Dim instance As EventWaitHandleSecurity Dim rule As EventWaitHandleAccessRule Dim returnValue As Boolean returnValue = instance.RemoveAccessRule(rule)
- rule
検索対象のユーザーと AccessControlType、および一致する規則が見つかった場合にその規則と互換性のある継承フラグと反映フラグのセットを指定する EventWaitHandleAccessRule。互換性のある規則が見つかった場合にその規則から削除する権限を指定します。
互換性のある規則が見つかった場合は true。それ以外の場合は false。


現在の EventWaitHandleSecurity で、rule と同じユーザーおよび同じ AccessControlType 値が指定された規則が検索されます。そのような規則が見つからない場合は、何も行われません。メソッドは false を返します。一致する規則が見つかった場合は、規則の継承フラグおよび互換性フラグについて、rule で指定されたフラグとの互換性がチェックされます。互換性のある規則が見つからない場合は、何も行われません。メソッドは false を返します。互換性フラグを含む規則が見つかった場合、rule で指定された規則は互換性のある規則から削除され、メソッドは true を返します。rule が互換性のある規則に含まれていない権限を指定した場合、これらの権限に関する処理は実行されません。互換性のある規則からすべての権限が削除されると、現在の EventWaitHandleSecurity オブジェクトから規則全体が削除されます。
![]() |
---|
AccessRuleFactory メソッドで継承フラグと反映フラグを作成することによってイベントのアクセス規則にこれらのフラグを指定できますが、この方法はお勧めできません。継承と反映は、名前付きイベントに対して無効です。また、これらのフラグを指定することによってアクセス規則の保守が複雑になります。 |

RemoveAccessRule メソッドを使用して EventWaitHandleSecurity オブジェクトの Allow 規則から権限を削除するコード例を次に示します。また、この例では、rule 内のその他の権限が無視されます。
この例では、EventWaitHandleSecurity オブジェクトを作成し、現在のユーザーの各種権限を許可および拒否する規則を追加します。許可される権限は、Modify、ReadPermissions、および Synchronize です。さらに、この例では、ReadPermissions 権や TakeOwnership 権などを含む新しい規則を現在のユーザーに対して作成し、この規則と RemoveAccessRule メソッドを使用して EventWaitHandleSecurity オブジェクト内の Allow 規則から ReadPermissions を削除します。rule 内の TakeOwnership 権限は無視されます。
![]() |
---|
この例では、セキュリティ オブジェクトが EventWaitHandle オブジェクトに割り当てられません。セキュリティ オブジェクトの割り当て例については、EventWaitHandle.GetAccessControl および EventWaitHandle.SetAccessControl のトピックを参照してください。 |
Imports System 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
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 */

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


Weblioに収録されているすべての辞書からEventWaitHandleSecurity.RemoveAccessRule メソッドを検索する場合は、下記のリンクをクリックしてください。

- EventWaitHandleSecurity.RemoveAccessRule メソッドのページへのリンク