Función GetExplicitEntriesFromAclA (aclapi.h)
La función GetExplicitEntriesFromAcl recupera una matriz de estructuras que describen las entradas de control de acceso (ACE) en una lista de control de acceso (ACL).
Sintaxis
DWORD GetExplicitEntriesFromAclA(
[in] PACL pacl,
[out] PULONG pcCountOfExplicitEntries,
[out] PEXPLICIT_ACCESS_A *pListOfExplicitEntries
);
Parámetros
[in] pacl
Puntero a una estructura de ACL desde la que se va a obtener información de ACE .
[out] pcCountOfExplicitEntries
Puntero a una variable que recibe el número de estructuras de EXPLICIT_ACCESS devueltas en la matriz pListOfExplicitEntries .
[out] pListOfExplicitEntries
Puntero a una variable que recibe un puntero a una matriz de estructuras de EXPLICIT_ACCESS que describen los ACL en la ACL. Si la función se realiza correctamente, debe llamar a la función LocalFree para liberar el búfer devuelto.
Valor devuelto
Si la función se realiza correctamente, la función devuelve ERROR_SUCCESS.
Si se produce un error en la función, devuelve un código de error distinto de cero definido en WinError.h.
Comentarios
Cada entrada de la matriz de estructuras de EXPLICIT_ACCESS describe la información de control de acceso de una ACE para un administrador de confianza. Un administrador de confianza puede ser un usuario, un grupo o un programa (por ejemplo, un servicio de Windows).
Cada estructura de EXPLICIT_ACCESS especifica un conjunto de derechos de acceso y una marca de modo de acceso que indica si la ACE permite, deniega o audita los derechos especificados.
Para una lista de control de acceso discrecional (DACL), la marca de modo de acceso puede ser GRANT_ACCESS o DENY_ACCESS. Para obtener información sobre estos valores, consulte ACCESS_MODE.
Para una lista de control de acceso del sistema (SACL), la marca de modo de acceso puede ser SET_AUDIT_ACCESS, SET_AUDIT_FAILURE o ambos. Para obtener información sobre estos valores, consulte ACCESS_MODE.
Nota
El encabezado aclapi.h define GetExplicitEntriesFromAcl como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
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 | aclapi.h |
| Library | Advapi32.lib |
| Archivo DLL | Advapi32.dll |