estructura EXPLICIT_ACCESS_A (accctrl.h)

Artículo
11/20/2024

La estructura EXPLICIT_ACCESS define la información de control de acceso para un administrador de confianza especificado. Funciones de control de acceso, como SetEntriesInAcl y GetExplicitEntriesFromAcl, use esta estructura para describir la información de un entrada de control de acceso(ACE) de una lista de control de acceso (ACL).

Sintaxis

typedef struct _EXPLICIT_ACCESS_A {
  DWORD       grfAccessPermissions;
  ACCESS_MODE grfAccessMode;
  DWORD       grfInheritance;
  TRUSTEE_A   Trustee;
} EXPLICIT_ACCESS_A, *PEXPLICIT_ACCESS_A, EXPLICIT_ACCESSA, *PEXPLICIT_ACCESSA;

Miembros

grfAccessPermissions

Conjunto de marcas de bits que usan el formato ACCESS_MASK para especificar los derechos de acceso que una ACE permite, deniega o audita para el administrador de confianza. Las funciones que usan la estructura EXPLICIT_ACCESS no convierten, interpretan ni validan los bits de esta máscara.

grfAccessMode

Valor de la enumeración ACCESS_MODE. Para una lista de control de acceso discrecional (DACL), esta marca indica si la ACL permite o deniega los derechos de acceso especificados. Para un lista de control de acceso del sistema (SACL), esta marca indica si la ACL genera mensajes de auditoría para los intentos correctos de usar los derechos de acceso especificados, o los intentos erróneos, o ambos. Al modificar una ACL existente, puede especificar la marca de REVOKE_ACCESS para quitar los ACE existentes para el administrador de confianza especificado.

grfInheritance

Un conjunto de marcas de bits que determina si otros contenedores o objetos pueden heredar la ACE del objeto principal al que está adjunta la ACL. El valor de este miembro corresponde a la parte de herencia (byte de orden bajo) del miembro AceFlags de la estructura de ACE_HEADER. Este parámetro puede ser NO_INHERITANCE para indicar que la ACE no se puede heredar; o puede ser una combinación de los siguientes valores.

Valor	Significado
CONTAINER_INHERIT_ACE	Otros contenedores que contiene el objeto principal heredan la ACE.
INHERIT_NO_PROPAGATE	Hereda pero no se propague.
INHERIT_ONLY	Hereda solo.
INHERIT_ONLY_ACE	La ACE no se aplica al objeto principal al que se adjunta la ACL, pero los objetos contenidos por el objeto principal heredan la ACE.
NO_INHERITANCE	No herede.
NO_PROPAGATE_INHERIT_ACE	Las marcas OBJECT_INHERIT_ACE y CONTAINER_INHERIT_ACE no se propagan a una ACE heredada.
OBJECT_INHERIT_ACE	Los objetos no contenidos en el objeto principal heredan la ACE.
SUB_CONTAINERS_AND_OBJECTS_INHERIT	Tanto los contenedores como los objetos no contenedor que contiene el objeto principal heredan la ACE. Esta marca corresponde a la combinación de las marcas CONTAINER_INHERIT_ACE y OBJECT_INHERIT_ACE.
SUB_CONTAINERS_ONLY_INHERIT	Otros contenedores que contiene el objeto principal heredan la ACE. Esta marca corresponde a la marca CONTAINER_INHERIT_ACE.
SUB_OBJECTS_ONLY_INHERIT	Los objetos no contenidos en el objeto principal heredan la ACE. Esta marca corresponde a la marca OBJECT_INHERIT_ACE.

Trustee

Una estructura TRUSTEE que identifica al usuario, grupo o programa (como un servicio de Windows) al que se aplica la ACE.

Observaciones

Nota

El encabezado accctrl.h define EXPLICIT_ACCESS_ 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 [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
encabezado de	accctrl.h