Función GetSecurityDescriptorDacl (securitybaseapi.h)
La función GetSecurityDescriptorDacl recupera un puntero a la lista de control de acceso discrecional (DACL) en un descriptor de seguridad especificado.
Sintaxis
BOOL GetSecurityDescriptorDacl(
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor,
[out] LPBOOL lpbDaclPresent,
[out] PACL *pDacl,
[out] LPBOOL lpbDaclDefaulted
);
Parámetros
[in] pSecurityDescriptor
Puntero a la estructura SECURITY_DESCRIPTOR que contiene la DACL. La función recupera un puntero a él.
[out] lpbDaclPresent
Puntero a un valor que indica la presencia de una DACL en el descriptor de seguridad especificado. Si lpbDaclPresent es TRUE, el descriptor de seguridad contiene una DACL y los parámetros de salida restantes de esta función reciben valores válidos. Si lpbDaclPresent es FALSE, el descriptor de seguridad no contiene una DACL y los parámetros de salida restantes no reciben valores válidos.
Un valor true paralpbDaclPresent no significa que pDacl no sea NULL. Es decir, lpbDaclPresent puede ser TRUE mientras que pDacl es NULL, lo que significa que una DACL NULL está en vigor. Una DACL NULL permite implícitamente todo el acceso a un objeto y no es el mismo que una DACL vacía. Una DACL vacía no permite el acceso a un objeto . Para obtener información sobre cómo crear una DACL adecuada, vea Creating a DACL.
[out] pDacl
Puntero a un puntero a una lista de control de acceso (ACL). Si existe una DACL, la función establece el puntero al que apunta pDacl en la dirección de la DACL del descriptor de seguridad. Si no existe una DACL, no se almacena ningún valor.
Si la función almacena un valor NULL en el puntero al que apunta pDacl, el descriptor de seguridad tiene una DACL NULL . Una DACL NULL permite implícitamente todo el acceso a un objeto .
Si una aplicación espera una DACL que no es NULL , pero encuentra una DACL NULL , la aplicación debe producir un error de forma segura y no permitir el acceso.
[out] lpbDaclDefaulted
Puntero a una marca establecida en el valor de la marca SE_DACL_DEFAULTED en la estructura SECURITY_DESCRIPTOR_CONTROL si existe una DACL para el descriptor de seguridad. Si esta marca es TRUE, la DACL se recuperó mediante un mecanismo predeterminado; si es FALSE, un usuario especificó explícitamente la DACL.
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 |