estrutura ACTRL_ACCESS_ENTRYA (accctrl.h)

2024-11-20

Contém informações de controle de acesso para um administrador especificado. Essa estrutura armazena informações equivalentes às informações de controle de acesso armazenadas em umace .

Sintaxe

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;

Membros

Trustee

Um estrutura que identifica o usuário, o grupo ou o programa (como um serviço) ao qual a entrada de controle de acesso se aplica.

fAccessFlags

Indica como os direitos de acesso especificados pelo Access e ProvSpecificAccess membros se aplicam ao administrador. Esse membro pode ser um dos seguintes valores. Se você estiver usando essa estrutura com a implementação COM de IAccessControl, esse membro deverá ser ACTRL_ACCESS_ALLOWED ou ACTRL_ACCESS_DENIED.

Valor	Significado
ACTRL_ACCESS_ALLOWED 0x00000001	Os direitos são permitidos.
ACTRL_ACCESS_DENIED 0x00000002	Os direitos são negados.
ACTRL_AUDIT_SUCCESS 0x00000004	O sistema gera mensagens de auditoria para tentativas com falha ao usar os direitos.
ACTRL_AUDIT_FAILURE 0x00000008	O sistema gera mensagens de auditoria para tentativas bem-sucedidas de usar os direitos.

Access

Uma máscara de bits que especifica os direitos de acesso que a entrada permite, nega ou audita para o administrador.

Esse membro deve usar os sinalizadores de acesso independentes do provedor, como ACTRL_READ_CONTROL, em vez de acessar sinalizadores como READ_CONTROL. O provedor do tipo de objeto converte esses sinalizadores independentes do provedor nos sinalizadores específicos do provedor correspondentes.

Se você estiver usando essa estrutura com a implementação COM de IAccessControl, esse membro deverá 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

Uma máscara de bits que especifica direitos de acesso específicos ao tipo de provedor. As funções que usam a estrutura ACTRL_ACCESS_ENTRY passam esses bits para o provedor sem interpretá-los. Na maioria dos casos, esse membro deve ser 0.

Inheritance

Um conjunto de sinalizadores de bits que determina se outros contêineres ou objetos podem herdar a entrada de controle de acesso do objeto primário ao qual a lista de acesso está anexada. Se você estiver usando essa estrutura com a implementação COM de IAccessControl, esse valor deverá ser NO_INHERITANCE, o que indica que a entrada de controle de acesso não é herdável. Caso contrário, esse valor pode ser NO_INHERITANCE ou pode ser uma combinação dos valores a seguir.

Valor	Significado
CONTAINER_INHERIT_ACE 0x2	Outros contêineres contidos pelo objeto primário herdam a entrada.
INHERIT_ONLY_ACE 0x8	O ACE não se aplica ao objeto primário ao qual a ACL está anexada, mas os objetos contidos pelo objeto primário herdam a entrada.
NO_PROPAGATE_INHERIT_ACE 0x4	Os sinalizadores OBJECT_INHERIT_ACE e CONTAINER_INHERIT_ACE não são propagados para uma entrada herdada.
OBJECT_INHERIT_ACE 0x1	Objetos não pertencentes ao objeto primário herdam a entrada.
SUB_CONTAINERS_AND_OBJECTS_INHERIT 0x3	Tanto os contêineres quanto os objetos não pertencentes ao objeto primário herdam a entrada. Esse sinalizador corresponde à combinação dos sinalizadores CONTAINER_INHERIT_ACE e OBJECT_INHERIT_ACE.
SUB_CONTAINERS_ONLY_INHERIT 0x2	Outros contêineres contidos pelo objeto primário herdam a entrada. Esse sinalizador corresponde ao sinalizador CONTAINER_INHERIT_ACE.
SUB_OBJECTS_ONLY_INHERIT 0x1	Objetos não pertencentes ao objeto primário herdam a entrada. Esse sinalizador corresponde ao sinalizador OBJECT_INHERIT_ACE.

lpInheritProperty

Um ponteiro para uma cadeia de caracteres terminada em nulo que identifica os tipos de objeto que podem herdar a entrada. Se você estiver usando essa estrutura com a implementação COM de IAccessControl, esse membro deverá ser NULL.

Observações

Nota

O cabeçalho accctrl.h define ACTRL_ACCESS_ENTRY como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
cabeçalho	accctrl.h

Consulte também

ACTRL_ACCESS_ENTRY_LIST

do TRUSTEE