GetSecurityDescriptorSacl-Funktion (securitybaseapi.h)
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 |