Función SetSecurityDescriptorSacl (securitybaseapi.h)
La función SetSecurityDescriptorSacl establece información en una lista de control de acceso del sistema (SACL). Si ya hay una SACL presente en el descriptor de seguridad, se reemplazará.
Sintaxis
BOOL SetSecurityDescriptorSacl(
[in, out] PSECURITY_DESCRIPTOR pSecurityDescriptor,
[in] BOOL bSaclPresent,
[in, optional] PACL pSacl,
[in] BOOL bSaclDefaulted
);
Parámetros
[in, out] pSecurityDescriptor
Puntero a la estructura SECURITY_DESCRIPTOR a la que la función agrega la SACL. Este descriptor de seguridad debe tener un formato absoluto, lo que significa que sus miembros deben ser punteros a otras estructuras, en lugar de desplazarse a datos contiguos.
[in] bSaclPresent
Indica la presencia de una SACL en el descriptor de seguridad. Si este parámetro es TRUE, la función establece la marca SE_SACL_PRESENT en la estructura SECURITY_DESCRIPTOR_CONTROL y usa los valores de los parámetros pSacl y bSaclDefaulted . Si es FALSE, la función no establece la marca SE_SACL_PRESENT y se omiten pSacl y bSaclDefaulted .
[in, optional] pSacl
Puntero a una estructura de ACL que especifica la SACL para el descriptor de seguridad. Si este parámetro es NULL, se asigna un SACL NULL al descriptor de seguridad. El descriptor de seguridad hace referencia a SACL, no se copia en .
[in] bSaclDefaulted
Indica el origen de la SACL. Si esta marca es TRUE, el SACL se ha recuperado mediante algún mecanismo predeterminado. Si es FALSE, un usuario ha especificado explícitamente la SACL. La función almacena este valor en la marca SE_SACL_DEFAULTED de la estructura SECURITY_DESCRIPTOR_CONTROL . Si no se especifica este parámetro, la marca SE_SACL_DEFAULTED se borra.
Valor devuelto
Si la función se ejecuta correctamente, la función devuelve un valor distinto de cero.
Si se produce un error en la función, devuelve cero. Para obtener información de error extendida, llame a GetLastError.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [aplicaciones de escritorio | aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | securitybaseapi.h (incluya Windows.h) |
| Library | Advapi32.lib |
| Archivo DLL | Advapi32.dll |