FileSystemSecurity.RemoveAccessRuleSpecific(FileSystemAccessRule) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Removes a single matching allow or deny access control list (ACL) permission from the current file or directory.
public:
void RemoveAccessRuleSpecific(System::Security::AccessControl::FileSystemAccessRule ^ rule);
public void RemoveAccessRuleSpecific (System.Security.AccessControl.FileSystemAccessRule rule);
override this.RemoveAccessRuleSpecific : System.Security.AccessControl.FileSystemAccessRule -> unit
Public Sub RemoveAccessRuleSpecific (rule As FileSystemAccessRule)
Parameters
- rule
- FileSystemAccessRule
A FileSystemAccessRule object that specifies a user whose access control list (ACL) permissions should be removed from a file or directory.
Exceptions
The rule
parameter is null
.
Remarks
The RemoveAccessRuleSpecific method removes the specified Deny access rule or the specified matching Allow access rule from the current FileSystemSecurity object. For example, you can use this method to remove a specified Deny access rule for a user by passing a FileSystemAccessRule object created using the Deny value, the Read value, and a user account. When you do this, the RemoveAccessRuleSpecific method removes only the deny rule that specifies the Read value. It does not remove any deny rules that specify the Write value.
To persist new or changed access control list (ACL) information to a file, use the SetAccessControl or SetAccessControl method. To persist new or changed ACL information to a directory, use the SetAccessControl or SetAccessControl method.
To retrieve ACL information from a file, use the GetAccessControl or GetAccessControl method. To retrieve ACL information from a directory, use the GetAccessControl or GetAccessControl method.
When you add an access rule without setting the Synchronize flag, the Synchronize flag will be automatically added to your rule. If you remove the rule later without specifying the Synchronize flag, the flag will automatically be removed.
Applies to
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應