Directory.SetAccessControl(String, DirectorySecurity) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee past u ACL-vermeldingen (Access Control List) toe die worden beschreven door een DirectorySecurity object op de opgegeven map.
public:
static void SetAccessControl(System::String ^ path, System::Security::AccessControl::DirectorySecurity ^ directorySecurity);public static void SetAccessControl(string path, System.Security.AccessControl.DirectorySecurity directorySecurity);static member SetAccessControl : string * System.Security.AccessControl.DirectorySecurity -> unitPublic Shared Sub SetAccessControl (path As String, directorySecurity As DirectorySecurity)Parameters
- path
- String
Een map waaruit u ACL-vermeldingen (Access Control List) wilt toevoegen of verwijderen.
- directorySecurity
- DirectorySecurity
Een DirectorySecurity object dat een ACL-vermelding beschrijft die moet worden toegepast op de map die door de path parameter wordt beschreven.
Uitzonderingen
De directorySecurity parameter is null.
Kan de map niet vinden.
De path was ongeldig.
Het huidige proces heeft geen toegang tot de map die is opgegeven door path.
– of –
Het huidige proces heeft onvoldoende bevoegdheden om de ACL-vermelding in te stellen.
Opmerkingen
Met de SetAccessControl methode worden ACL-vermeldingen (Access Control List) toegepast op een map die de niet-ingevoegde ACL-lijst vertegenwoordigt.
Caution
De ACL die is opgegeven voor de directorySecurity parameter vervangt de bestaande ACL voor de map. Als u machtigingen voor een nieuwe gebruiker wilt toevoegen, gebruikt u de GetAccessControl methode om de bestaande ACL te verkrijgen en te wijzigen.
Een ACL beschrijft personen en groepen die al dan niet beschikken over specifieke acties voor het opgegeven bestand of de opgegeven map. Zie Instructies voor het toevoegen of verwijderen van vermeldingen in toegangsbeheerlijsten voor meer informatie.
De SetAccessControl methode behoudt alleen DirectorySecurity objecten die zijn gewijzigd na het maken van het object. Als een DirectorySecurity object niet is gewijzigd, wordt het niet opgeslagen in een bestand. Daarom is het niet mogelijk om een object op te halen uit het DirectorySecurity ene bestand en hetzelfde object opnieuw toe te past op een ander bestand.
ACL-gegevens van het ene bestand naar het andere kopiëren:
Gebruik de GetAccessControl methode om het DirectorySecurity object op te halen uit het bronbestand.
Maak een nieuw DirectorySecurity object voor het doelbestand.
Gebruik de GetSecurityDescriptorBinaryForm of GetSecurityDescriptorSddlForm methode van het bronobject DirectorySecurity om de ACL-informatie op te halen.
Gebruik de SetSecurityDescriptorBinaryForm of SetSecurityDescriptorSddlForm methode om de gegevens die in stap 3 zijn opgehaald, te kopiëren naar het doelobject DirectorySecurity .
Stel het doelobject DirectorySecurity in op het doelbestand met behulp van de SetAccessControl methode.
In NTFS-omgevingen ReadAttributes en ReadExtendedAttributes worden aan de gebruiker verleend als de gebruiker rechten heeft ListDirectory op de bovenliggende map. ReadAttributes Weigeren en ReadExtendedAttributesweigeren ListDirectory in de bovenliggende map.
