FileSystemSecurity.RemoveAccessRuleSpecific(FileSystemAccessRule) Methode

Definition

Entfernt eine einzelne entsprechende Allow- oder Deny-ACL-Berechtigung zum Gewähren oder Verweigern aus der aktuellen Datei bzw. dem Verzeichnis.

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)

Parameter

rule
FileSystemAccessRule

Ein FileSystemAccessRule-Objekt, das einen Benutzer angibt, dessen ACL-Berechtigungen aus einer Datei oder einem Verzeichnis entfernt werden sollen.

Ausnahmen

Der rule-Parameter ist null.

Hinweise

Die RemoveAccessRuleSpecific Methode entfernt die angegebene Deny Zugriffsregel oder die angegebene übereinstimmende Allow Zugriffsregel aus dem aktuellen FileSystemSecurity Objekt. Sie können beispielsweise diese Methode verwenden, um eine angegebene Deny Zugriffsregel für einen Benutzer zu entfernen, indem Sie ein FileSystemAccessRule Objekt übergeben, das mithilfe des Werts, des Deny Read Werts und eines Benutzerkontos erstellt wurde. Wenn Sie dies tun, entfernt die RemoveAccessRuleSpecific Methode nur die Verweigerungsregel, die den Read Wert angibt. Es werden keine Ablehnungsregeln entfernt, die den Write Wert angeben.

Um neue oder geänderte Zugriffssteuerungslisteninformationen (Access Control List, ACL) in einer Datei beizubehalten, verwenden Sie die SetAccessControl Methode SetAccessControl . Wenn Sie neue oder geänderte ACL-Informationen in einem Verzeichnis beibehalten möchten, verwenden Sie die Methode oder SetAccessControl die SetAccessControl Methode.

Um ACL-Informationen aus einer Datei abzurufen, verwenden Sie die Methode oder GetAccessControl die GetAccessControl Methode. Um ACL-Informationen aus einem Verzeichnis abzurufen, verwenden Sie die GetAccessControl oder GetAccessControl die Methode.

Wenn Sie eine Zugriffsregel hinzufügen, ohne das Synchronize Kennzeichen festzulegen, wird das Synchronize Kennzeichen automatisch zu Ihrer Regel hinzugefügt. Wenn Sie die Regel später entfernen, ohne das Synchronize Kennzeichen anzugeben, wird das Kennzeichen automatisch entfernt.

Gilt für