estructura de ACTRL_ACCESS_ENTRYA (accctrl.h)

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 una 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

Estructura DE CONFIANZA 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 los miembros de Access y 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 la entrada permite, deniega o audita 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 u objetos pueden heredar la entrada de control de acceso del objeto principal al que se 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 contenidos en 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 noncontainer 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 contenidos en el objeto principal heredan la entrada. Esta marca corresponde a la marca CONTAINER_INHERIT_ACE.
SUB_OBJECTS_ONLY_INHERIT
0x1
Los objetos noncontainer 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.

Comentarios

Nota

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

Consulte también

ACTRL_ACCESS_ENTRY_LIST

FIDEICOMISARIO