Función SetSecurityDescriptorSacl (securitybaseapi.h)

Artículo
03/15/2023

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