Función GetExplicitEntriesFromAclA (aclapi.h)

Artículo
11/20/2024

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 de ACL desde la que obtener información de ACE.

[out] pcCountOfExplicitEntries

Puntero a una variable que recibe el número de estructuras 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 ejecuta correctamente, debe llamar a la función LocalFree para liberar el búfer devuelto.

Valor devuelto

Si la función se ejecuta 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.

Observaciones

Cada entrada de la matriz de estructuras de EXPLICIT_ACCESS describe la información de control de acceso de un ACE para un administrador de confianza. Un administrador de confianza puede ser un usuario, grupo o programa (como 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 un 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, vea ACCESS_MODE.

Para un 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, vea 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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [aplicaciones de escritorio \| Aplicaciones para UWP]
servidor mínimo admitido	Windows Server 2003 [aplicaciones de escritorio \| Aplicaciones para UWP]
de la plataforma de destino de	Windows
encabezado de	aclapi.h
biblioteca de	Advapi32.lib
DLL de	Advapi32.dll