Compartir a través de


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

Consulte también

ACL

GetSecurityDescriptorSacl

InitializeSecurityDescriptor

IsValidSecurityDescriptor

Access Control de bajo nivel

Funciones de Access Control de bajo nivel

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SetSecurityDescriptorDacl

SetSecurityDescriptorGroup

SetSecurityDescriptorOwner