GetSecurityDescriptorSacl-Funktion (securitybaseapi.h)

Artikel
03/04/2024

Die GetSecurityDescriptorSacl-Funktion ruft einen Zeiger auf die Systemzugriffssteuerungsliste (SACL ) in einem angegebenen Sicherheitsdeskriptor ab.

Syntax

BOOL GetSecurityDescriptorSacl(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] LPBOOL               lpbSaclPresent,
  [out] PACL                 *pSacl,
  [out] LPBOOL               lpbSaclDefaulted
);

Parameter

[in] pSecurityDescriptor

Ein Zeiger auf die SECURITY_DESCRIPTOR-Struktur , die die SACL enthält, auf die die Funktion einen Zeiger abruft.

[out] lpbSaclPresent

Ein Zeiger auf ein Flag, das die Funktion festlegt, um das Vorhandensein einer SACL im angegebenen Sicherheitsdeskriptor anzugeben. Wenn dieser Parameter TRUE ist, enthält der Sicherheitsdeskriptor eine SACL, und die verbleibenden Ausgabeparameter in dieser Funktion erhalten gültige Werte. Wenn dieser Parameter FALSE ist, enthält der Sicherheitsdeskriptor keine SACL, und die verbleibenden Ausgabeparameter erhalten keine gültigen Werte.

[out] pSacl

Ein Zeiger auf einen Zeiger auf eine Zugriffssteuerungsliste (Access Control List , ACL). Wenn eine SACL vorhanden ist, legt die Funktion den Zeiger, auf den pSacl zeigt, auf die Adresse der SACL des Sicherheitsdeskriptors fest. Wenn keine SACL vorhanden ist, wird kein Wert gespeichert.

Wenn die Funktion einen NULL-Wert im Zeiger speichert, auf den pSacl verweist, weist der Sicherheitsdeskriptor eine NULL-SACL auf.

[out] lpbSaclDefaulted

Ein Zeiger auf ein Flag, das auf den Wert des SE_SACL_DEFAULTED-Flags in der SECURITY_DESCRIPTOR_CONTROL-Struktur festgelegt ist, wenn eine SACL für den Sicherheitsdeskriptor vorhanden ist.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion ungleich null zurück.

Wenn die Funktion fehlschlägt, wird null zurückgegeben. 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ßen von Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll