Compartir a través de


Función GetSecurityDescriptorSacl (securitybaseapi.h)

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

Consulte también

GetSecurityDescriptorControl

GetSecurityDescriptorDacl

GetSecurityDescriptorGroup

GetSecurityDescriptorLength

GetSecurityDescriptorOwner

InitializeSecurityDescriptor

IsValidSecurityDescriptor

Access Control de bajo nivel

Funciones de Access Control de bajo nivel

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SetSecurityDescriptorSacl