SetSecurityDescriptorSacl-Funktion (securitybaseapi.h)

Artikel
03/04/2024

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