Función GetExplicitEntriesFromAclA (aclapi.h)

Artículo
03/05/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 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