estructura de EXPLICIT_ACCESS_A (accctrl.h)

Artículo
02/26/2024

La estructura EXPLICIT_ACCESS define la información de control de acceso para un administrador de confianza especificado. Las funciones de control de acceso, como SetEntriesInAcl y GetExplicitEntriesFromAcl, usan esta estructura para describir la información de una 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 una lista de control de acceso del sistema (SACL), esta marca indica si la ACL genera mensajes de auditoría para intentos correctos de usar los derechos de acceso especificados, o los intentos con errores, o ambos. Al modificar una ACL existente, puede especificar la marca de REVOKE_ACCESS para quitar las ACE existentes para el administrador de confianza especificado.

grfInheritance

Un conjunto de marcas de bits que determina si otros contenedores u objetos pueden heredar la ACE del objeto principal al que está asociada la ACL. El valor de este miembro corresponde a la parte de herencia (byte de orden bajo) del miembro AceFlags de la estructura 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 valores siguientes.

Valor	Significado
CONTAINER_INHERIT_ACE	Otros contenedores contenidos por el objeto principal heredan la ACE.
INHERIT_NO_PROPAGATE	Heredar, pero no propagarse.
INHERIT_ONLY	Solo herencia.
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 noncontainer contenidos por el objeto principal heredan la ACE.
SUB_CONTAINERS_AND_OBJECTS_INHERIT	Tanto los contenedores como los objetos no contenidos en 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 contenidos por el objeto principal heredan la ACE. Esta marca corresponde a la marca CONTAINER_INHERIT_ACE.
SUB_OBJECTS_ONLY_INHERIT	Los objetos noncontainer contenidos por el objeto principal heredan la ACE. Esta marca corresponde a la marca OBJECT_INHERIT_ACE.

Trustee

Estructura DE CONFIANZA que identifica al usuario, grupo o programa (por ejemplo, un servicio de Windows) al que se aplica la ACE.

Comentarios

Nota

El encabezado accctrl.h define EXPLICIT_ACCESS_ como un 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 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	accctrl.h