Función GetSecurityDescriptorSacl (securitybaseapi.h)

Artículo
03/05/2024

La función GetSecurityDescriptorSacl recupera un puntero a la lista de control de acceso del sistema (SACL) en un descriptor de seguridad especificado.

Sintaxis

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

Parámetros

[in] pSecurityDescriptor

Puntero a la estructura SECURITY_DESCRIPTOR que contiene la SACL a la que la función recupera un puntero.

[out] lpbSaclPresent

Puntero a una marca que establece la función para indicar la presencia de una SACL en el descriptor de seguridad especificado. Si este parámetro es TRUE, el descriptor de seguridad contiene una SACL y el resto de parámetros de salida de esta función reciben valores válidos. Si este parámetro es FALSE, el descriptor de seguridad no contiene una SACL y los parámetros de salida restantes no reciben valores válidos.

[out] pSacl

Puntero a un puntero a una lista de control de acceso (ACL). Si existe una SACL, la función establece el puntero al que apunta pSacl en la dirección del SACL del descriptor de seguridad. Si no existe una SACL, no se almacena ningún valor.

Si la función almacena un valor NULL en el puntero al que apunta pSacl, el descriptor de seguridad tiene un SACL NULL .

[out] lpbSaclDefaulted

Puntero a una marca que se establece en el valor de la marca de SE_SACL_DEFAULTED en la estructura SECURITY_DESCRIPTOR_CONTROL si existe una SACL para el descriptor de seguridad.

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