Freigeben über


SetSecurityDescriptorSacl-Funktion (securitybaseapi.h)

Die SetSecurityDescriptorSacl-Funktion legt Informationen in einer Systemzugriffssteuerungsliste (SACL ) fest. Wenn bereits eine SACL im Sicherheitsdeskriptor vorhanden ist, wird sie ersetzt.

Syntax

BOOL SetSecurityDescriptorSacl(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]           BOOL                 bSaclPresent,
  [in, optional] PACL                 pSacl,
  [in]           BOOL                 bSaclDefaulted
);

Parameter

[in, out] pSecurityDescriptor

Ein Zeiger auf die SECURITY_DESCRIPTOR-Struktur , der die Funktion die SACL hinzufügt. Dieser Sicherheitsdeskriptor muss ein absolutes Format aufweisen, was bedeutet, dass seine Member auf andere Strukturen zeigen müssen, anstatt auf zusammenhängende Daten zu offseten.

[in] bSaclPresent

Gibt das Vorhandensein einer SACL in der Sicherheitsbeschreibung an. Wenn dieser Parameter TRUE ist, legt die Funktion das SE_SACL_PRESENT-Flag in der SECURITY_DESCRIPTOR_CONTROL-Struktur fest und verwendet die Werte in den Parametern pSacl und bSaclDefaulted . Wenn es FALSE ist, legt die Funktion das SE_SACL_PRESENT-Flag nicht fest, und pSaclUnd bSaclDefaulted werden ignoriert.

[in, optional] pSacl

Ein Zeiger auf eine ACL-Struktur , die die SACL für die Sicherheitsbeschreibung angibt. Wenn dieser Parameter NULL ist, wird dem Sicherheitsdeskriptor eine NULL-SACL zugewiesen. Auf die SACL wird vom Sicherheitsdeskriptor verwiesen und nicht in diese kopiert.

[in] bSaclDefaulted

Gibt die Quelle der SACL an. Wenn dieses Flag TRUE ist, wurde die SACL von einem Standardmechanismus abgerufen. Wenn es FALSE ist, wurde die SACL von einem Benutzer explizit angegeben. Die Funktion speichert diesen Wert im SE_SACL_DEFAULTED Flag der SECURITY_DESCRIPTOR_CONTROL-Struktur . Wenn dieser Parameter nicht angegeben wird, wird das flag SE_SACL_DEFAULTED gelöscht.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion nonzero zurück.

Wenn die Funktion fehlschlägt, gibt sie null zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile securitybaseapi.h (einschließlich Windows.h)
Bibliothek Advapi32.lib
DLL Advapi32.dll

Weitere Informationen

ACL

GetSecurityDescriptorSacl

InitializeSecurityDescriptor

IsValidSecurityDescriptor

Low-Level-Access Control

Access Control funktionen auf niedriger Ebene

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SetSecurityDescriptorDacl

SetSecurityDescriptorGroup

SetSecurityDescriptorOwner