Función GetExplicitEntriesFromAclW (aclapi.h)

Artículo
08/22/2023

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 GetExplicitEntriesFromAclW(
  [in]  PACL               pacl,
  [out] PULONG             pcCountOfExplicitEntries,
  [out] PEXPLICIT_ACCESS_W *pListOfExplicitEntries
);

Parámetros

[in] pacl

Puntero a una estructura de ACL desde la que 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 ACA 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.

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 puede ser un usuario, un grupo o un 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 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 ambas. 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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