estructura ACTRL_ACCESS_ENTRYA (accctrl.h)

Artículo
11/20/2024

Contiene información de control de acceso para un administrador de confianza especificado. Esta estructura almacena información equivalente a la información de control de acceso almacenada en un ACE.

Sintaxis

typedef struct _ACTRL_ACCESS_ENTRYA {
  TRUSTEE_A     Trustee;
  ULONG         fAccessFlags;
  ACCESS_RIGHTS Access;
  ACCESS_RIGHTS ProvSpecificAccess;
  INHERIT_FLAGS Inheritance;
  LPSTR         lpInheritProperty;
} ACTRL_ACCESS_ENTRYA, *PACTRL_ACCESS_ENTRYA;

Miembros

Trustee

Una estructura TRUSTEE que identifica al usuario, grupo o programa (por ejemplo, un servicio) al que se aplica la entrada de control de acceso.

fAccessFlags

Indica cómo se aplican los derechos de acceso especificados por el de Access y miembros de ProvSpecificAccess al administrador de confianza. Este miembro puede ser uno de los siguientes valores. Si usa esta estructura con la implementación COM de IAccessControl, este miembro debe ser ACTRL_ACCESS_ALLOWED o ACTRL_ACCESS_DENIED.

Valor	Significado
ACTRL_ACCESS_ALLOWED 0x00000001	Se permiten los derechos.
ACTRL_ACCESS_DENIED 0x00000002	Se deniegan los derechos.
ACTRL_AUDIT_SUCCESS 0x00000004	El sistema genera mensajes de auditoría para intentos erróneos de usar los derechos.
ACTRL_AUDIT_FAILURE 0x00000008	El sistema genera mensajes de auditoría para intentos correctos de usar los derechos.

Access

Máscara de bits que especifica los derechos de acceso que permite, deniega o audita la entrada para el administrador de confianza.

Este miembro debe usar las marcas de acceso independientes del proveedor, como ACTRL_READ_CONTROL, en lugar de marcas de acceso como READ_CONTROL. El proveedor del tipo de objeto convierte estas marcas independientes del proveedor en las marcas específicas del proveedor correspondientes.

Si usa esta estructura con la implementación COM de IAccessControl, este miembro debe ser COM_RIGHTS_EXECUTE.

ACTRL_SYSTEM_ACCESS

ACTRL_DELETE

ACTRL_READ_CONTROL

ACTRL_CHANGE_ACCESS

ACTRL_CHANGE_OWNER

ACTRL_SYNCHRONIZE

ACTRL_STD_RIGHTS_ALL

ACTRL_STD_RIGHT_REQUIRED

COM_RIGHTS_EXECUTE

COM_RIGHTS_EXECUTE_LOCAL

COM_RIGHTS_EXECUTE_REMOTE

COM_RIGHTS_ACTIVATE_LOCAL

COM_RIGHTS_ACTIVATE_REMOTE

ProvSpecificAccess

Máscara de bits que especifica derechos de acceso específicos del tipo de proveedor. Las funciones que usan la estructura ACTRL_ACCESS_ENTRY pasan estos bits al proveedor sin interpretarlos. En la mayoría de los casos, este miembro debe ser 0.

Inheritance

Un conjunto de marcas de bits que determina si otros contenedores o objetos pueden heredar la entrada de control de acceso del objeto principal al que está adjunta la lista de acceso. Si usa esta estructura con la implementación COM de IAccessControl, este valor debe ser NO_INHERITANCE, lo que indica que la entrada de control de acceso no se puede heredar. De lo contrario, este valor puede ser NO_INHERITANCE o puede ser una combinación de los valores siguientes.

Valor	Significado
CONTAINER_INHERIT_ACE 0x2	Otros contenedores que contiene el objeto principal heredan la entrada.
INHERIT_ONLY_ACE 0x8	La ACE no se aplica al objeto principal al que se adjunta la ACL, pero los objetos contenidos por el objeto principal heredan la entrada.
NO_PROPAGATE_INHERIT_ACE 0x4	Las marcas OBJECT_INHERIT_ACE y CONTAINER_INHERIT_ACE no se propagan a una entrada heredada.
OBJECT_INHERIT_ACE 0x1	Los objetos no contenidos en el objeto principal heredan la entrada.
SUB_CONTAINERS_AND_OBJECTS_INHERIT 0x3	Tanto los contenedores como los objetos no contenedor que contiene el objeto principal heredan la entrada. Esta marca corresponde a la combinación de las marcas CONTAINER_INHERIT_ACE y OBJECT_INHERIT_ACE.
SUB_CONTAINERS_ONLY_INHERIT 0x2	Otros contenedores que contiene el objeto principal heredan la entrada. Esta marca corresponde a la marca CONTAINER_INHERIT_ACE.
SUB_OBJECTS_ONLY_INHERIT 0x1	Los objetos no contenidos en el objeto principal heredan la entrada. Esta marca corresponde a la marca OBJECT_INHERIT_ACE.

lpInheritProperty

Puntero a una cadena terminada en null que identifica los tipos de objeto que pueden heredar la entrada. Si usa esta estructura con la implementación COM de IAccessControl, este miembro debe ser NULL.

Observaciones

Nota

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

Consulte también

ACTRL_ACCESS_ENTRY_LIST

DE CONFIANZA

Compartir a través de